gemini
Use when the user asks to run Gemini CLI for code review, plan review, or big context (>200k) processing. Ideal for comprehensive analysis requiring large context windows. Uses Gemini 3 Pro by default for state-of-the-art reasoning and coding.
By softaworks · 3,892 installs
npx skills add softaworks/agent-toolkit --skill gemini
Source repository · Upstream listing
Gemini Skill Guide
When to Use Gemini
WHEN ASKED TO BE ACTIVATED
Code Review : Comprehensive code reviews across multiple files
Plan Review : Analyzing architectural plans, technical specifications, or project roadmaps
Big Context Processing : Tasks requiring 200k tokens of context (entire codebases, documentation sets)
Multi file Analysis : Understanding relationships and patterns across many files
⚠️ Critical: Background/Non Interactive Mode Warning
NEVER use approval mode default in background or non interactive shells (like Claude Code tool calls). It will hang indefinitely waiting for approval prompts that cannot be provided.
For automated/background reviews:
✅ Use approval mode yolo for fully automated execution
✅ OR wrap with timeout: timeout 300 gemini ...
❌ NEVER use approval mode default without interactive terminal
Symptoms of hung Gemini:
Process running 20+ minutes with 0% CPU usage
No network activity
Process state shows 'S' (sleeping)
Fix hung process:
Running a Task
1. Ask the user (via AskUserQuestion ) which model to use in a single prompt . Available models:
gemini 3 pro preview ⭐ (flagship model, best for coding & complex reasoning, 35% better at software engineering than 2.5 Pro)
gemini 3 flash (sub second latency, distilled from 3 Pro, best for speed critical tasks)
gemini 2.5 pro (legacy option, strong all around performance)
gemini 2.5 flash (legacy option, cost efficient with thinking capabilities)
gemini 2.5 flash lite (legacy option, fastest processing)
2. Select the approval mode based on the task:
default : Prompt for approval (⚠️ ONLY for interactive terminal sessions)
auto edit : Auto approve edit tools only (for code reviews with suggestions)
yolo : Auto approve all tools (✅ REQUIRED for background/automated tasks)
3. Assemble the command with appropriate options:
m, model <MODEL Model selection
approval mode <default auto edit yolo Control tool approval
y, yolo Alternative to approval mode yolo
i, prompt interactive "prompt" Execute prompt and continue interactively
include directories <DIR Additional directories to include in workspace
s, sandbox Run in sandbox mode for isolation
4. For background/automated tasks, ALWAYS use approval mode yolo or add timeout wrapper. NEVER use default in non interactive shells.
5. Run the command and capture the output. For background/automated mode:
6. For interactive sessions with an initial prompt:
7. After Gemini completes , inform the user: "The Gemini analysis is complete. You can start a new Gemini session for follow up analysis or continue exploring the findings."
Quick Reference
Use case Approval mode Key flags
Background code review yolo ✅ m gemini 3 pro preview approval mode yolo
Background analysis yolo ✅ m gemini 3 pro preview approval mode yolo
Background with timeout yolo ✅ timeout 300 gemini m gemini 3 pro preview approval mode yolo
Interactive code review default m gemini 3 pro preview approval mode default (interactive terminal only)
Code review with auto edits auto edit m gemini 3 pro preview approval mode auto edit
Automated refactoring yolo m gemini 3 pro preview approval mode yolo
Speed critical background yolo ✅ m gemini 3 flash approval mode yolo
Cost optimized background yolo ✅ m gemini 2.5 flash approval mode yolo
Multi directory analysis yolo (if background) include directories <DIR1 include directories <DIR2
Interactive with prompt auto edit or default i "prompt" approval mode <mode
Model Selection Guide
Model Best for Context window Key features
gemini 3 pro preview ⭐ Flagship model : Complex reasoning, coding, agentic tasks 1M input / 64k output Vibe coding, 76.2% SWE bench, $2 4/M input
gemini 3 flash Sub second latency, speed critical applications 1M input / 64k output Distilled from 3 Pro, TPU optimized
gemini 2.5 pro Legacy: Strong all around performance 1M input / 65k output Thinking mode, mature stability
gemini 2.5 flash Legacy: Cost efficient, high volume tasks 1M input / 65k output Best price ($0.15/M), thinking mode
gemini 2.5 flash lite Legacy: Fastest processing, high throughput 1M input / 65k output Maximum speed, minimal latency
Gemini 3 Advantages : 35% higher accuracy in software engineering, state of the art on SWE bench (76.2%), GPQA Diamond (91.9%), and WebDev Arena (1487 Elo). Knowledge cutoff: January 2025.
Coming Soon : gemini 3 deep think for ultra complex reasoning with enhanced thinking capabilities.
Common Use Cases
Code Review (Background/Automated)
Plan Review (Background/Automated)
Big Context Analysis (Background/Automated)
Interactive Code Review (Terminal Only)
Following Up
Gemini CLI sessions are typically one shot or interactive. Unlike Codex, there's no built in resume functionality.
For follow up analysis, start a new Gemini session with context from previous findings.
When proposing follow up actions, restate the chosen model and approval mode.
Use AskUserQuestion after each Gemini command to confirm next steps or gather clarifications.
Error Handling
Stop and report failures whenever gemini version or a Gemini command exits non zero.
Request direction before retrying failed commands.
Before using high impact flags ( approval mode yolo , y , sandbox ), ask the user for permission using AskUserQuestion unless already granted.
When output includes warnings or partial results, summarize them and ask how to adjust using AskUserQuestion .
Troubleshooting Hung Gemini Processes
Detection
Diagnosis
Resolution
Prevention
ALWAYS use approval mode yolo for background/automated tasks
Add timeout wrapper for safety: timeout 300 gemini ...
Never use approval mode default in non interactive shells
Monitor first run with ps to ensure process completes
Tips for Large Context Processing
1. Be specific : Provide clear, structured prompts for what to analyze
2. Use include directories : Explicitly specify all relevant directories
3. Choose the right model :
Use gemini 3 pro preview for complex reasoning, coding tasks, and maximum analysis quality (recommended default)
Use gemini 3 flash for speed critical tasks requiring sub second response times
Use gemini 2.5 flash for cost optimized high volume processing
4. Leverage Gemini 3's strengths : 35% better at software engineering tasks, exceptional at agentic workflows and vibe coding
5. Break down complex tasks : Even with large context, structured analysis is more effective
6. Save findings : Ask Gemini to output structured reports that can be saved for reference
CLI Version
Requires Gemini CLI v0.16.0 or later for Gemini 3 model support. Check version: gemini version