Gemini Guide
Look up Gemini API documentation and SDK patterns when building with Google Gemini. This skill brings Gemini docs TO Claude — it does not call Gemini.
| Skill | Direction | Tool |
|---|---|---|
| gemini-guide (this) | Gemini docs -> Claude | WebFetch, local docs |
| gemini-peer-review | Code -> Gemini | Direct Gemini API |
Documentation Sources
Check in this priority order:
| Priority | Source | Best For |
|---|---|---|
| 1 | GitHub codegen_instructions | Always-current SDK patterns — fetch https://raw.githubusercontent.com/googleapis/js-genai/refs/heads/main/codegen_instructions.md |
| 2 | Google AI docs via WebFetch | Official docs — https://ai.google.dev/gemini-api/docs/{topic} (append .md.txt for markdown) |
| 3 | Local cached docs (if available at ~/Documents/google-gemini-context/) | Pre-fetched topics — 24 JS, 24 Python, 7 common |
Lookup Workflow
When the user asks about a Gemini topic:
- Check corrections first: Read references/deprecated-patterns.md — know what NOT to suggest before writing any code
- Fetch latest SDK patterns: Get the GitHub codegen_instructions.md for always-current patterns
- Map the query to a topic: Read references/topic-index.md — if local docs exist at
~/Documents/google-gemini-context/, read the matching file; otherwise use WebFetch onhttps://ai.google.dev/gemini-api/docs/{topic}.md.txt - Synthesise: Combine the documentation into a clear answer with working code examples. Always use the CORRECT patterns from step 1.
Quick Corrections
These are the most common mistakes. Apply these even without reading the full references:
| Claude Might Suggest | Correct |
|---|---|
@google/generative-ai | @google/genai |
google-generativeai (Python) | google-genai |
GoogleGenerativeAI | GoogleGenAI |
genAI.getGenerativeModel() | ai.models.generateContent() |
model.startChat() / chat.sendMessage() | ai.chats.create() / chat.send() |
generationConfig | config |
stream=True (method param) | config={"stream": True} |
gemini-pro | gemini-2.5-flash |
gemini-pro-vision | gemini-2.5-flash (unified multimodal) |
| 4 safety categories | 5 categories (include HARM_CATEGORY_CIVIC_INTEGRITY) |
HARM_CATEGORY_DANGEROUS_CONTENT | HARM_CATEGORY_DANGEROUS (no _CONTENT) |
X-Goog-Api-Key (capitalised) | x-goog-api-key (lowercase) |
| Daily rate limits | No daily limits — only per-minute (RPM, TPM) |
Correct Initialisation (JS)
import { GoogleGenAI } from "@google/genai";
const ai = new GoogleGenAI({}); // auto-reads GEMINI_API_KEY env var
const response = await ai.models.generateContent({
model: "gemini-2.5-flash",
contents: "Your prompt"
});Correct Initialisation (Python)
from google import genai
client = genai.Client() # auto-reads GEMINI_API_KEY env var
response = client.models.generate_content(
model="gemini-2.5-flash",
contents="Your prompt"
)Local Docs (Optional)
If you have a local cache at ~/Documents/google-gemini-context/, it contains:
| Directory | Contents |
|---|---|
javascript/ | 24 topic files — quickstart, function-calling, streaming, structured-output, etc. |
python/ | 24 topic files — same topics as JavaScript |
common/ | 7 cross-language files — safety, pricing, rate-limits, errors, auth, regions, openai-compat |
rest-api/ | REST endpoint docs |
MODELS.md | Current model IDs, capabilities, token limits, rate limits |
googlegenai-gemini-api.md | Comprehensive SDK guide (608 lines, JS + Python) |
If not available, fall back to WebFetch on Google AI docs (append .md.txt for markdown format).
Current Models
| Model | ID | Best For |
|---|---|---|
| Gemini 2.5 Pro | gemini-2.5-pro | Complex reasoning, advanced coding |
| Gemini 2.5 Flash | gemini-2.5-flash | Most tasks (recommended default) |
| Gemini 2.5 Flash-Lite | gemini-2.5-flash-lite-preview-06-17 | Budget, low latency |
| Gemini 2.0 Flash | gemini-2.0-flash | Fast inference |
| Text Embedding | text-embedding-004 | Semantic search, RAG (768 dims) |
For full model details, check ~/Documents/google-gemini-context/MODELS.md (if available) or https://ai.google.dev/gemini-api/docs/models.
Maintenance
When information seems wrong or outdated:
- Check the GitHub codegen_instructions.md (always current)
- Verify model IDs against
https://ai.google.dev/gemini-api/docs/models - Flag stale docs to the user
Reference Files
| When | Read |
|---|---|
| Mapping a query to a documentation file | references/topic-index.md |
| Checking for deprecated patterns before writing code | references/deprecated-patterns.md |