williamzujkowski/Gemini CLI Delegation & Large Context Routing

Purpose & When-To-Use

Trigger Conditions:

Use this skill for fast delegation decisions when:

• Large file analysis: Single file >100KB
• Analysis/review tasks: Summarization, comprehension, codebase review
• Sandbox code testing: Safe execution of unfamiliar code

Do NOT use when:

• File <100KB and task is edit/refactor/debug (Claude excels here)
• Multi-file orchestration needed (use separate orchestration agent)
• Real-time debugging or iterative refinement

Pre-Checks

Timestamp & Environment

NOW_ET = 2025-10-26T01:18:53-04:00 (America/New_York, ISO-8601)

Required validations before delegation:

1. Input schema validation:

• task_description is non-empty string
• file_paths (if provided) resolve to accessible files

1. Security pre-flight:

• Scan file paths for patterns like .env, credentials.json, *.key, *.pem
• Abort if secrets detected; prompt user to sanitize

Procedure

Token Budget: T1≤2000 tokens

Tier 1 — Fast Delegation Decision (T1≤2000 tokens)

Two-step process:

1. Delegation gate (primary decision):

• If file size >100KB → delegate to Gemini
• If task type = analysis|review|summarize|codebase-review → delegate to Gemini
• Else → keep in Claude

1. Format output:

• If delegating: emit delegation_command for Gemini MCP
• Else: emit recommended_tool: "claude"
• Include brief rationale citing threshold

Decision Rules

Primary Routing Logic:

| Condition | Threshold | Action | |-----------|-----------|--------| | File size | >100KB | Delegate to Gemini | | Task type | analysis, review, summarize, codebase-review | Delegate to Gemini | | Sandbox execution | Any code testing | Delegate to Gemini | | Otherwise | Default | Keep in Claude |

Note: Complex multi-file orchestration belongs in a separate orchestration agent, not this skill.

Abort Conditions:

• Secrets detected in file paths or task description

Output Contract

Schema (TypeScript-style):

typescript
interface DelegationResult {
  delegation_decision: boolean;           // true = delegate to Gemini
  recommended_tool: "claude" | "gemini-mcp";
  delegation_command?: string;            // only if delegation_decision = true
  rationale: string;                      // max 160 chars, cites threshold
  security_flags: string[];               // empty if clean; else warnings
}

Required fields:

• delegation_decision, recommended_tool, rationale, security_flags (always)
• delegation_command (only if delegation_decision = true)

Examples

Example 1: Large File Analysis (Delegate)

yaml
# Input
task_description: "Summarize research paper"
file_paths: ["./paper.pdf"]
context_size_estimate: 3500  # KB

# Output
{
  "delegation_decision": true,
  "recommended_tool": "gemini-mcp",
  "delegation_command": "ask gemini to analyze @./paper.pdf and summarize key findings",
  "rationale": "File size 3.5MB > 100KB threshold",
  "security_flags": []
}

Example 2: Small File Edit (Keep in Claude)

yaml
# Input
task_description: "Refactor authentication function"
file_paths: ["./auth.py"]
context_size_estimate: 45  # KB

# Output
{
  "delegation_decision": false,
  "recommended_tool": "claude",
  "rationale": "File <100KB and task type 'refactor' suits Claude precision",
  "security_flags": []
}

Quality Gates

Token Budget Enforcement:

• Token budget: T1≤2k tokens for fast delegation decision (T2/T3 not applicable - skill simplified to T1 only)
• Examples must be ≤30 lines each (including fences)

Safety Checks:

• ] No API keys or secrets in delegation_command
• ] PII screening if task involves user data
• ] Sandbox isolation for code execution tasks

Determinism:

• Same inputs (file size, task type) must produce same delegation decision
• Rationale must cite specific threshold (e.g., "File size >100KB")

Resources

Primary Sources:

• Gemini MCP Tool Repository — MCP server implementation, CLI integration (accessed 2025-10-26T01:18:53-04:00)
• Gemini API Long Context Documentation — 1M token context window (accessed 2025-10-26T01:18:53-04:00)
• Model Context Protocol - Claude Docs — MCP specification (accessed 2025-10-26T01:18:53-04:00)

Configuration Templates:

• resources/mcp-config-template.json — Claude Desktop MCP setup for gemini-mcp-tool
• resources/delegation-decision-matrix.md — Static reference table (not computed during skill execution)