gemini-skill

A Claude Code skill that delegates coding tasks to Gemini CLI and supervises the result.

Claude orchestrates. Gemini codes. You review the diff.

---

What it does

When you type /gemini <instruction> in Claude Code, this skill:

1. Decomposes the task into atomic sub-tasks (if needed)
2. Chooses a mode: impl (writes files) or plan (read-only exploration)
3. Runs gemini-delegate — a shell script that launches Gemini CLI in headless mode
4. Streams structured output: [read], [write], [plan-write], [WARN], [SYNTAX ERROR]
5. Runs post-run syntax checks on modified .py and .js files automatically
6. Reports the git diff and any issues to you
7. Appends a structured JSON entry to ~/.local/share/delegate-runs.jsonl (tokens, cost, duration, exit code)

---

Prerequisites

• Gemini CLI installed and authenticated (gemini --version)
• Claude Code with skills enabled
• python3 available (for the streaming parser and syntax checks)
• node available (optional — for JS syntax checks)
• A git repository to work in

---

Installation

git clone https://github.com/pcx-wave/gemini-skill.git && cd gemini-skill && mkdir -p ~/tools ~/.claude/skills/gemini && ln -sf "$(pwd)/tools/gemini-delegate" ~/tools/gemini-delegate && ln -sf "$(pwd)/tools/delegate-report" ~/tools/delegate-report && chmod +x ~/tools/gemini-delegate ~/tools/delegate-report && ln -sf "$(pwd)/SKILL.md" ~/.claude/skills/gemini/SKILL.md

Step-by-step

# 1. Clone this repo
git clone https://github.com/pcx-wave/gemini-skill.git
cd gemini-skill

# 2. Install the scripts (symlinks — stay in sync with git pull)
mkdir -p ~/tools
ln -sf "$(pwd)/tools/gemini-delegate" ~/tools/gemini-delegate
ln -sf "$(pwd)/tools/delegate-report" ~/tools/delegate-report
chmod +x ~/tools/gemini-delegate ~/tools/delegate-report

# 3. Install the skill for Claude Code
mkdir -p ~/.claude/skills/gemini
ln -sf "$(pwd)/SKILL.md" ~/.claude/skills/gemini/SKILL.md

# 4. (Optional) Enable auto-mode — Claude delegates all code tasks automatically
#    without requiring /gemini each time. Toggle with /geminion and /geminioff.
grep -q "gemini auto-mode" ~/.claude/CLAUDE.md 2>/dev/null || cat >> ~/.claude/CLAUDE.md << 'EOF'

# gemini auto-mode
At the start of every user request that involves writing, editing, or fixing code:
1. Run `test -f ~/.local/share/gemini-auto.flag` (silent, no output to user).
2. If the flag exists → automatically invoke the `gemini` skill exactly as if the user had typed `/gemini <their full instruction>`. Do NOT ask first, do NOT explain — just delegate.
3. If the flag is absent → proceed normally.

The flag is toggled by `/geminion` and `/geminioff`.
EOF

Verify the install

# Check gemini is available
gemini --version

# Test the delegate script (plan mode — no writes)
~/tools/gemini-delegate /tmp "Say hello in one sentence." 120 plan
# Should print: [gemini] Hello! ...

Updating

Because the install uses symlinks, a git pull is all you need:

cd ~/gemini-skill && git pull

~/tools/gemini-delegate and all skill files are automatically up to date — no re-copy needed.

---

Usage

In a Claude Code session, just describe what you want:

/gemini add a dark mode toggle to the settings page

/gemini the login form is not validating the email field — fix it