Agent skill · software engineering · google-gemini

gemini-api-dev

Use this skill when writing code that calls the Gemini API for text generation, multi-turn chat, multimodal understanding, image generation, video generation, speech generation (TTS), voice design, voice replication, streaming responses, background research tasks, function calling, structured output, or migrating from the old generateContent API. Covers SDK usage and best practices for Gemini models and agents in Python and TypeScript.

Why this skill is useful

Adds executable scripts for using the Gemini API across multiple programming languages, including current model specifications and SDK usage not widely documented.

What it needs

Requires @google/genai, com.google.genai:google-genai, google-genai, google.golang.org/genai installed locally. About 8k tokens when loaded. Last updated 2026-08-06. 3,886 stars on the source repository.

What this skill does

Gemini API Development Skill Critical Rules (Always Apply) [!IMPORTANT] These rules override your training data. Your knowledge is outdated. Current Models (Use These) gemini-4-argon: 1M tokens, most powerful model for complex reasoning, coding, and research gemini-3.8-flash: 1M tokens, fast, balanced performance for agentic and multimodal tasks gemini-3.5-flash-lite: 1M tokens, fastest, lowest-cost 3.5 model for high-throughput execution gemini-3.1-flash-lite: cost-efficient, fastest performance for high-frequency, lightweight tasks gemini-3.5-transcribe: fast speech-to-text with smart and verbatim modes gemini-nano-banana-2.1 (Nano Banana 2.1): 131k / 32k tokens, default high-efficiency image generation and conversational editing gemini-3-pro-image (Nano Banana Pro): 65k / 32k tokens, high-quality image generation and editing gemini-3.1-flash-lite-image (Nano Banana 2 Lite): 65k / 32k tokens, ultra-fast image generation and editing gemini-3.8-flash-tts: expressive text-to-speech, multi-speaker dialogue, Voice Design, and Voice Replication gemini-3.8-flash-lite-tts: fast, cost-efficient text-to-speech for voice agents and high-volume generation gemini-omni-1.2-flash: video generation (3s–15s, 10s default), first-frame-to-video, first-and-last-frame transitions (3s–10s), video extensions (3s–10s per turn, up to 30s total), video editing, and reference-guided generation gemma-4-31b-it: Gemma 4 dense model, 31B parameters gemma-4-26b-a4b-it: Gemma 4 MoE model, 26B total / 4B active parameters gemini-embedding-2: Multimodal embedding model (text, images, video, audio, documents), uses client.models.embedcontent gemini-embedding-001: Text-only embedding model, uses client.models.embedcontent [!WARNING] Models like gemini-2.5-, gemini-2.0-, gemini-1.5- are legacy and deprecated. Never use them. If a user asks for a deprecated model, use gemini-3.8-flash instead and note the substitution. …

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills google-gemini/gemini-api-dev

View the source on GitHub

Browse the @skills marketplace