Gemini

What it does

The Gemini skill enables AI agents to perform comprehensive text generation and analysis, particularly suited for code review, plan review, and processing large amounts of context (over 200k tokens). It leverages various Gemini models – including gemini-3-pro-preview, gemini-3-flash, gemini-2.5-pro, gemini-2.5-flash, and gemini-2.5-flash-lite - to handle complex tasks efficiently. The skill is designed for both interactive and automated workflows, but requires careful configuration of approval modes.

When to use it

• Code Review: Analyzing code across multiple files to identify potential issues.
• Plan Review: Examining architectural plans, technical specifications, or project roadmaps for inconsistencies or areas needing improvement.
• Large Context Processing: Tasks involving extensive documentation sets or entire codebases that exceed typical token limits.
• Multi-file Analysis: Understanding relationships and patterns across numerous files within a project.

Key capabilities

• Supports multiple Gemini models: gemini-3-pro-preview, gemini-3-flash, gemini-2.5-pro, gemini-2.5-flash, and gemini-2.5-flash-lite.
• Offers different approval modes for interactive (default), automated editing (auto_edit), or fully automated execution (yolo).
• Capable of processing contexts exceeding 200,000 tokens.
• Designed for analyzing relationships and patterns across multiple files.

Example prompts

• "Please review this codebase using the gemini-3-pro-preview model with YOLO approval mode."
• "Can you analyze these architectural plans and identify any potential structural weaknesses, using the gemini-2.5-flash model?"
• "Review these technical specifications for consistency and completeness, selecting the best available Gemini model."

Tips & gotchas

• Approval Mode is Critical: Never use --approval-mode default in non-interactive environments (like automated tool calls) as it will cause the process to hang indefinitely. Use --approval-mode yolo for fully automated tasks or wrap execution with a timeout (timeout 300 gemini ...).
• Model Selection: The skill requires you to specify which Gemini model to use in a single prompt. Consider gemini-3-pro-preview for complex reasoning and coding, while gemini-3-flash prioritizes speed.
• Hung Process Symptoms: If the process runs for over 20 minutes with no CPU usage or network activity, it may be hung. Use ps aux | grep gemini | grep -v grep to check and pkill -9 -f "gemini.*gemini-3-pro-preview" to terminate if necessary.