Gemini Skill Guide

When to Use This Skill

1. User explicitly requests

   gemini

   CLI execution (Mode 1: Direct CLI)
2. Large-context analysis requiring 1M token window (Mode 2: Gemini Delegation)
3. Repository-scale code reviews and architectural analysis
4. Multimodal analysis (code + images/diagrams)
5. Cross-module dependency tracking

• Simple code explanations (use Claude directly)
• Small context tasks (<100K tokens)
• Tasks not requiring Gemini-specific capabilities

Execution Modes

Mode 1: Direct CLI Execution

1. Gather configuration using structured questions:
   • Model selection (gemini-3-pro-preview vs gemini-3-flash-preview)
   • Approval mode (default, auto_edit, yolo)
   • Output format (text, json, stream-json)
2. Execute:
   bash

   gemini "<PROMPT>" -m <MODEL> --approval-mode <MODE> --output-format <FORMAT>

3. Inform user: "You can resume with 'gemini --resume latest' anytime"

gemini "<CONTINUATION PROMPT>" --resume latest

Mode 2: Gemini Delegation for Large Context

1. Analyze context and identify what Gemini analysis would help
2. Formulate comprehensive query with all relevant context:
   • Problem statement
   • Current findings
   • Code snippets or file references
   • Specific questions
3. Leverage Gemini's 1M token context for comprehensive analysis
4. Execute:

   gemini "<DETAILED CONTEXT>" --output-format json

5. Synthesize Gemini response into actionable insights
6. Report findings with:
   • Clear summary of Gemini's analysis
   • Specific recommendations or solutions
   • Additional considerations or caveats
   • Next steps if applicable

Error Handling

• Verify gemini binary exists before execution:

  which gemini

• Stop immediately on non-zero exit codes and report to user
• Request direction before retrying failed commands
• Before using high-autonomy flags, confirm with user:

  • --yolo

    (auto-approve all actions)

  • --approval-mode yolo

Context Management

• Gemini excels at large context (up to 1M tokens)
• For massive contexts (>500K tokens), consider module-by-module summaries
• Use

  --include-directories

  to add additional workspace paths
• Leverage session resume for iterative refinement

Configuration Gathering Patterns

Initial Configuration (Mode 1, Step 1)

Select gemini configuration (model, approval mode, and output format):

1. "gemini-3-pro-preview / default / json (Recommended)" - High quality, safe mode
2. "gemini-3-pro-preview / auto_edit / json" - High quality, auto-approve edits
3. "gemini-3-flash-preview / default / json" - Fast, safe mode
4. "gemini-3-flash-preview / auto_edit / json" - Fast, auto-approve edits
5. "gemini-3-pro-preview / yolo / json" - High quality, fully autonomous
6. "gemini-3-flash-preview / yolo / json" - Fast, fully autonomous
7. "Custom" - User will specify model, approval, and format separately

High-Impact Flags Confirmation

Ready to execute with these flags: [LIST FLAGS]. Proceed?

1. "Execute now" - Run as configured
2. "Modify configuration" - Change settings
3. "Cancel" - Abort

Post-Execution Follow-up

Gemini completed. [SUMMARY]. Next steps?

1. "Resume with additional prompt" - Continue session
2. "Analyze results" - Review output
3. "Complete" - Finished
4. "Retry with different config" - Adjust settings

Error Recovery

Error: [SPECIFIC ERROR]. How to proceed?

1. "Resume with adjustments" - Fix and continue
2. "Retry with different config" - Change model/approval/format
3. "Accept partial results" - Use what worked
4. "Invoke heal-skill" - Fix outdated SKILL.md

Running a Task

1. Gather configuration using the patterns above
2. Assemble the command with the appropriate options:

   • -m, --model <MODEL>

     (gemini-3-pro-preview or gemini-3-flash-preview)

   • --approval-mode <MODE>

     (default, auto_edit, yolo)

   • -o, --output-format <FORMAT>

     (text, json, stream-json)

   • --include-directories <DIRS>

     (additional workspace paths)

   • -r, --resume <SESSION>

     (latest or session index)
3. Run the command, capture output, and summarize for the user
4. After Gemini completes, inform the user: "You can resume this Gemini session at any time by saying 'gemini resume' or asking me to continue."

Quick Reference

default

--approval-mode default --output-format json

auto_edit

--approval-mode auto_edit --output-format json

yolo

--yolo --output-format json

--resume latest

--include-directories <DIRS>

-i "<PROMPT>"

Model Selection

gemini-3-pro-preview

gemini-3-flash-preview

Session Management

# List available sessions
gemini --list-sessions

# Resume most recent session
gemini --resume latest

# Resume specific session by index
gemini --resume 5

# Delete a session
gemini --delete-session 3

MCP Server Integration

# List configured MCP servers
gemini mcp list

# Add an MCP server
gemini mcp add <name> <command> [args...]

# Remove an MCP server
gemini mcp remove <name>

# Limit to specific MCP servers
gemini "<PROMPT>" --allowed-mcp-server-names mcp-skillset

Extension System

# List installed extensions
gemini extensions list

# Install extension from git or path
gemini extensions install <source> [--auto-update] [--pre-release]

# Update extensions
gemini extensions update [--all]

# Disable/enable extension
gemini extensions disable <name>
gemini extensions enable <name>

Following Up

• After every

  gemini

  command, offer follow-up options
• When resuming, use:

  gemini "<new prompt>" --resume latest

• The resumed session automatically uses the same context from the original
• Restate the chosen model and approval mode when proposing follow-up actions

Error Handling Guidelines

• Stop and report failures whenever

  gemini --version

  or a

  gemini

  command exits non-zero; request direction before retrying
• Confirm high-impact flags before execution
• When output includes warnings or partial results, offer error recovery options

Comparison with Codex Skill

Integration Patterns

With Other CLI Agents

# Use gemini for large context, codex for GPT-specific
gemini "Analyze entire codebase architecture" --output-format json
codex exec "Implement specific feature based on analysis" --full-auto

# Chain with research CLI
research docs -t "framework API" --format json | gemini "Apply this to codebase"

Multimodal Analysis

# Gemini can process images inline with code
gemini "Analyze this architecture diagram and compare with implementation" \
  --include-directories ./docs ./src

Heal-Skill Integration

1. Detection: Notice command failures or API mismatches during execution
2. Trigger: Flag skill for healing via

   /heal-skill gemini

3. Analysis: Healing agent analyzes current CLI with

   gemini --help

   and

   gemini --version

4. Update: Updates skill documentation to match current API
5. Validation: Re-validates agent configuration for compatibility
6. Model Verification: Ensures only gemini-3 models are referenced
7. Context Window Verification: Confirms 1M token context window specifications

• New or deprecated command flags
• Changes to approval modes or output formats
• Model availability updates (gemini-3 family)
• MCP server integration API changes
• Session management API modifications
• Extension system updates
• Context window specification changes