skill-gemini

Gemini CLI Integration for Claude Code

Purpose

Enable Claude Code to invoke the Gemini CLI (gemini -p and session resumes) for automated code analysis, refactoring, codebase investigation, and multi-model collaboration workflows.

Prerequisites

• Gemini CLI installed and available on PATH.
• Gemini configured with valid credentials (OAuth or API key).
• Confirm the installation by running gemini --version; resolve any errors before using the skill.

Installation

This repository is structured as a Claude Code Plugin with a marketplace. You can install it as a plugin (recommended) or extract it as a standalone skill.

Option 1: Plugin Installation (Recommended)

Install via Claude Code's plugin system for automatic updates:

/plugin marketplace add integralmedia1/skill-gemini
/plugin install skill-gemini@skill-gemini

Option 2: Standalone Skill Installation

Extract the skill folder manually:

git clone --depth 1 [email protected]:integralmedia1/skill-gemini.git /tmp/skill-gemini-temp && \
mkdir -p ~/.claude/skills && \
cp -r /tmp/skill-gemini-temp/plugins/skill-gemini/skills/gemini ~/.claude/skills/gemini && \
rm -rf /tmp/skill-gemini-temp

Usage

Important: Debug Output

By default, this skill suppresses debug/progress output (stderr) using 2>/dev/null to avoid bloating Claude Code's context window. If you want to see debug output for troubleshooting, explicitly ask Claude to show it (uses the -d flag).

Example Workflow

User prompt:

Use gemini to review this project's authentication logic for security issues.

Claude Code response: Claude will activate the Gemini skill and:

1. Ask which model to use (gemini-3.1-pro-preview, gemini-3-pro-preview, gemini-3-flash-preview, etc.) unless already specified in your prompt.
2. Ask which approval mode (plan, auto_edit, yolo, or default) unless already specified.
3. Select appropriate approval mode (defaults to plan for read-only analysis).
4. Run a command like:

gemini -m gemini-3-pro-preview \
  --approval-mode plan \
  -o text \
  -p "Review the authentication logic in this project for security vulnerabilities..." 2>/dev/null

Result: Claude will summarize the Gemini analysis output, highlighting key findings and asking if you'd like to continue with follow-up actions.

Models

Model	Best For
gemini-3.1-pro-preview	Most capable, complex reasoning
gemini-3-pro-preview	Default, strong general purpose
gemini-3-flash-preview	Fast tasks, simple analysis
gemini-2.5-pro	Fallback for complex tasks
gemini-2.5-flash	Balanced speed and quality

Approval Modes

Mode	Behavior
plan	Read-only, no file modifications (default for analysis)
auto_edit	Auto-approves file edits, prompts for shell commands
yolo	Auto-approves all actions (recommended for full delegation)
default	Prompts for approval on each action

Session Management

Gemini sessions persist and can be resumed:

# Resume most recent session
gemini -r latest -p "continue with..."

# List all sessions
gemini --list-sessions

# Resume specific session by index
gemini -r 3 -p "follow up on..."

Detailed Instructions

See plugins/skill-gemini/skills/gemini/SKILL.md for complete operational instructions, CLI options, and workflow guidance.

License

MIT License - see LICENSE for details.