# Gemini Delegate > Delegate tasks to Gemini CLI for Google search grounding with citations, large diff analysis using 2M token context, or Python code execution sandbox. Use when Claude needs web research with cited sources, when diffs exceed truncation thresholds, when algorithm verification requires code execution, or when the user explicitly asks to use Gemini. Invoke with /gemini for direct delegation or /gemini-search for search-grounded queries. Use when this capability is needed. - Skill: `tomevault-io/gemini-delegate-2` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/gemini-delegate-2` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/gemini-delegate-2/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Research & Search - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/gemini-delegate-2 --- # Gemini Delegation Invoke Gemini CLI as a subagent for tasks where Gemini has a demonstrable advantage over Claude's native tools. Gemini is always supplementary — never a replacement for Claude's primary workflow. ## When to Delegate | Advantage | Use Case | Why Gemini | |-----------|----------|------------| | **Google Search Grounding** | Web research, current best practices, framework docs | Auto-cites sources with URLs. More reliable than WebSearch for structured, authoritative results. | | **2M Token Context** | Full diff analysis when diffs exceed 5000 lines | No truncation needed. Claude's dm-review truncates to 200 lines/file at this threshold. | | **Code Execution Sandbox** | Algorithm verification, math validation, data transformation testing | Python sandbox with NumPy/SymPy. Claude can only analyze statically. | | **Cost Efficiency** | Bulk factual lookups, simple extraction tasks | Flash-lite is extremely cheap for delegated grunt work. | ## When NOT to Delegate - Tasks requiring Claude's conversation context (Gemini is stateless) - Tasks requiring MCP server access (Gemini can't reach Claude's MCP servers) - Tasks where Claude's native tools work well (don't delegate for delegation's sake) - Interactive or multi-turn workflows (each Gemini call is a fresh session) ## Invocation Protocol Load the full protocol from `${CLAUDE_SKILL_DIR}/references/invocation-protocol.md`. It covers CLI syntax, input methods (direct `-p` for short prompts, heredoc for large inputs), JSON response parsing (`{response, stats}`), error response format, the four failure modes (timeout, empty, malformed, rate limit), the **Fallback chain** wrapper (`references/gemini-wrapper.sh`) that walks `pro → flash → flash-lite` on real 429s (the CLI does not auto-fall-back), and shell safety rules. Key rules: always wrap with `timeout`, always use `--yolo` for automated flows, always use heredoc with quoted delimiter (`<<'GEMINI_INPUT'`) for content containing code or user input. All failures are graceful skips. ## Model Selection Load the full decision table from `${CLAUDE_SKILL_DIR}/references/model-selection.md`. It maps task types to models (`flash-lite`, `flash`, `pro`), timeouts, and expected latency. **Rate limit fallback chain:** `pro` → `flash` → `flash-lite` → skip ## Prompt Engineering Load templates from `${CLAUDE_SKILL_DIR}/references/prompt-templates.md`. Key principles: 1. **Self-contained prompts.** Gemini has no conversation context. Every prompt must include all necessary information — the task, the context, the expected output format, and any constraints. 2. **Structured output requests.** Always tell Gemini what format you need. For dm-review integration, request P1/P2/P3 findings. For research, request URL + title + excerpt structure. 3. **No tool assumptions.** Don't assume Gemini will use specific tools (search, code execution). Frame the prompt so the task is clear; Gemini decides which tools to invoke. 4. **Escape handling.** When piping code or diffs, use heredoc with quoted delimiter (`<<'GEMINI_INPUT'`) to prevent shell expansion. ## Available Agents This skill provides three specialized agents for common delegation patterns: | Agent | File | Purpose | |-------|------|---------| | **gemini-diff-analyst** | `plugins/gemini/agents/review/gemini-diff-analyst.md` | Full-diff review using 2M context | | **gemini-search-grounded** | `plugins/gemini/agents/workflow/gemini-search-grounded.md` | Web research with cited sources | | **gemini-code-executor** | `plugins/gemini/agents/workflow/gemini-code-executor.md` | Python sandbox code verification | ## Prerequisites Gemini CLI must be installed and authenticated: ```bash # Verify installation which gemini # Should return /opt/homebrew/bin/gemini or similar # Verify authentication gemini -p "test" -m flash-lite --output-format json --raw-output # If not installed: npm install -g @google/gemini-cli # If not authenticated: gemini auth login ``` The invoking Claude Code session must have Bash permissions for `gemini` commands. If the first invocation is blocked by permissions, report to the user and skip gracefully. --- > Source: [Design-Machines-Studio/depot](https://github.com/Design-Machines-Studio/depot) — distributed by [TomeVault](https://tomevault.io).