Gemini CLI Integration Skill

---

name: gemini-cli description: Wield Google's Gemini CLI as a powerful auxiliary tool for code generation, review, analysis, and web research. Use when tasks benefit from a second AI perspective, current web information via Google Search, codebase architecture analysis, or parallel code generation. Also use when user explicitly requests Gemini operations. allowed-tools:

• Bash
• Read
• Write
• Grep
• Glob

---

Gemini CLI Integration Skill

This skill enables Claude Code to effectively orchestrate Gemini CLI (v0.16.0+) with Gemini 3 Pro for code generation, review, analysis, and specialized tasks.

When to Use This Skill

Ideal Use Cases

1. **Second Opinion / Cross-Validation**

   • Code review after writing code (different AI perspective)
   • Security audit with alternative analysis
   • Finding bugs Claude might have missed

2. **Google Search Grounding**

   • Questions requiring current internet information
   • Latest library versions, API changes, documentation updates
   • Current events or recent releases

3. **Codebase Architecture Analysis**

   • Use Gemini's codebase_investigator tool
   • Understanding unfamiliar codebases
   • Mapping cross-file dependencies

4. **Parallel Processing**

   • Offload tasks while continuing other work
   • Run multiple code generations simultaneously
   • Background documentation generation

5. **Specialized Generation**

   • Test suite generation
   • JSDoc/documentation generation
   • Code translation between languages

When NOT to Use

• Simple, quick tasks (overhead not worth it)
• Tasks requiring immediate response (rate limits cause delays)
• When context is already loaded and understood
• Interactive refinement requiring conversation

Core Instructions

1. Verify Installation

command -v gemini || which gemini

2. Basic Command Pattern

gemini "[prompt]" --yolo -o text 2>&1

Key flags:

• --yolo or -y: Auto-approve all tool calls
• -o text: Human-readable output
• -o json: Structured output with stats
• -m gemini-2.5-flash: Use faster model for simple tasks

3. Critical Behavioral Notes

**YOLO Mode Behavior**: Auto-approves tool calls but does NOT prevent planning prompts. Gemini may still present plans and ask "Does this plan look good?" Use forceful language:

• "Apply now"
• "Start immediately"
• "Do this without asking for confirmation"

**Rate Limits**: Free tier has 60 requests/min, 1000/day. CLI auto-retries with backoff. Expect messages like "quota will reset after Xs".

4. Output Processing

For JSON output (`-o json`), parse:

{
  "response": "actual content",
  "stats": {
    "models": { "tokens": {...} },
    "tools": { "byName": {...} }
  }
}

Quick Reference Commands

Code Generation

gemini "Create [description] with [features]. Output complete file content." --yolo -o text

Code Review

gemini "Review [file] for: 1) features, 2) bugs/security issues, 3) improvem