A Gemini API front end that runs as a Claude Code skill or as a direct CLI. Two entry points, one command surface:
- Claude Code skill:
/gemini <command> [args] - direct CLI:
python3 scripts/gemini_run.py <command> [args]or thegemini-skill-installlauncher
Same command surface in both: text, multimodal analysis, structured output, embeddings, Files API, image/video/music generation, file search, deep research, and iterative plan review.
Claude Code skill (recommended):
uvx gemini-skill-installFallback: uvx --python 3.13 gemini-skill-install. See docs/install.md.
Direct CLI (no Claude Code required):
pipx install gemini-skill-install
# or from a clone:
git clone https://github.com/reshinto/gemini-skill.git && cd gemini-skill
python3 -m venv .venv && source .venv/bin/activate
pip install -r setup/requirements.txtSee docs/cli.md for full CLI setup.
Set GEMINI_API_KEY (the only supported key; GOOGLE_API_KEY is ignored). The launcher merges keys from all sources below; later entries override earlier ones, so ./.env wins and existing process env is the fallback:
- existing process env (lowest priority)
~/.claude/settings.json./.claude/settings.json./.claude/settings.local.json./.env(highest priority)
Full details and examples: docs/security.md.
Claude Code:
/gemini text "Explain quantum computing in three sentences"
Direct CLI:
python3 scripts/gemini_run.py text "Explain quantum computing in three sentences"Interactive plan-review REPL (CLI only):
python3 scripts/gemini_run.py plan_review- docs/README.md — documentation hub
- docs/install.md — skill install paths and verification
- docs/cli.md — CLI install and usage
- docs/usage.md — quickstart across both entry points
- docs/usage-tour.md — end-to-end examples
- docs/commands.md — command families
- docs/architecture.md — module layout
- docs/system-design.md — scalability, reliability, fallbacks
- docs/design-patterns.md — patterns used
- docs/security.md — secret handling
- reference/index.md — per-command reference
MIT