AgentSkillsCN

running-gemini-cli

利用 Google 的 Gemini 模型，执行 Gemini CLI，实现基于 AI 的代码分析与生成。当需要从不同视角获取 AI 建议、进行复杂推理，或借助 Gemini 实现代码生成时，可选用此工具。触发条件包括“Gemini”、“Google AI”，或在请求 Gemini 特定分析时使用。

SKILL.md
--- frontmatter
name: running-gemini-cli
description: Executes Gemini CLI for AI-powered code analysis and generation using Google's Gemini models. Use when needing alternative AI perspectives, complex reasoning, or code generation with Gemini. Triggers include "gemini", "Google AI", or when requesting Gemini-specific analysis.
context: fork
allowed-tools: Bash, Read

Gemini CLI Integration

Overview

Execute Gemini CLI commands with support for multiple models and flexible prompt input. Integrates Google's Gemini AI models into Claude Code workflows.

When to Use

  • •Complex reasoning tasks requiring advanced AI capabilities
  • •Code generation and analysis with Gemini models
  • •Tasks requiring Google's latest AI technology
  • •Alternative perspective on code problems

Usage

Mandatory: Run via uv with fixed timeout 7200000ms (foreground):

bash
uv run ~/.claude/skills/gemini/scripts/gemini.py "<prompt>" [working_dir]

Optional (direct execution or using Python):

bash
~/.claude/skills/gemini/scripts/gemini.py "<prompt>" [working_dir]
# or
python3 ~/.claude/skills/gemini/scripts/gemini.py "<prompt>" [working_dir]

Environment Variables

  • •GEMINI_MODEL: Configure model (default: gemini-3-pro-preview)
    • •Example: export GEMINI_MODEL=gemini-3

Timeout Control

  • •Fixed: 7200000 milliseconds (2 hours), immutable
  • •Bash tool: Always set timeout: 7200000 for double protection

Parameters

  • •prompt (required): Task prompt or question
  • •working_dir (optional): Working directory (default: current directory)

Return Format

Plain text output from Gemini:

text
Model response text here...

Error format (stderr):

text
ERROR: Error message

Invocation Pattern

When calling via Bash tool, always include the timeout parameter:

yaml
Bash tool parameters:
- command: uv run ~/.claude/skills/gemini/scripts/gemini.py "<prompt>"
- timeout: 7200000
- description: <brief description of the task>

Alternatives:

yaml
# Direct execution (simplest)
- command: ~/.claude/skills/gemini/scripts/gemini.py "<prompt>"

# Using python3
- command: python3 ~/.claude/skills/gemini/scripts/gemini.py "<prompt>"

Examples

Basic query:

bash
uv run ~/.claude/skills/gemini/scripts/gemini.py "explain quantum computing"
# timeout: 7200000

Code analysis:

bash
uv run ~/.claude/skills/gemini/scripts/gemini.py "review this code for security issues: $(cat app.py)"
# timeout: 7200000

With specific working directory:

bash
uv run ~/.claude/skills/gemini/scripts/gemini.py "analyze project structure" "/path/to/project"
# timeout: 7200000

Using python3 directly (alternative):

bash
python3 ~/.claude/skills/gemini/scripts/gemini.py "your prompt here"

Notes

  • •Recommended: Use uv run for automatic Python environment management (requires uv installed)
  • •Alternative: Direct execution ./gemini.py (uses system Python via shebang)
  • •Python implementation using standard library (zero dependencies)
  • •Cross-platform compatible (Windows/macOS/Linux)
  • •PEP 723 compliant (inline script metadata)
  • •Requires Gemini CLI installed and authenticated
  • •Supports all Gemini model variants (configure via GEMINI_MODEL environment variable)
  • •Output is streamed directly from Gemini CLI