Agent skill

claude-router

Choose between the local Codex CLI and Gemini CLI from Claude Code. Use for automatic model selection when the user wants the best local delegate for code review, repo-wide analysis, planning, or implementation.

Stars 114
Forks 23

Install this agent skill to your Project

npx add-skill https://github.com/sonichi/sutando/tree/main/skills/claude-router

SKILL.md

Claude Router

Route a task from Claude Code to either local codex or local gemini using simple, explicit rules. This skill assumes the dedicated claude-codex and claude-gemini skills are installed from this repo.

Usage: /claude-router [prompt]

ARGUMENTS: $ARGUMENTS

Routing Rules

  • Route to codex for:
    • code review
    • bug hunting in a small or medium code slice
    • implementation requests
    • patch validation on current changes
  • Route to gemini for:
    • repo-wide scans
    • architecture and dependency tracing
    • large-context summarization
    • multimodal or structured JSON output requests

If the request explicitly names codex or gemini, honor that directly.

Default Behavior

  • Default review-oriented prompts to Codex.
  • Default broad analysis prompts to Gemini in plan approval mode.
  • Keep execution in the current workspace unless the user requested a different directory.

Quick Checks

bash
bash "$SKILL_DIR/scripts/route-ai.sh" --check

Common Commands

bash
# Auto-route based on prompt
bash "$SKILL_DIR/scripts/route-ai.sh" -- "Review the current diff for regressions"

# Force Codex
bash "$SKILL_DIR/scripts/route-ai.sh" --engine codex -- "Inspect src/task-bridge.ts for races"

# Force Gemini
bash "$SKILL_DIR/scripts/route-ai.sh" --engine gemini -- "Trace task flow across the entire repo"

# Dry-run the route decision without executing
bash "$SKILL_DIR/scripts/route-ai.sh" --dry-run -- "Summarize architecture risks in this repo"

If Invoked As A Slash Command

  • If ARGUMENTS is empty, explain the route rules and suggest a plain prompt.
  • If ARGUMENTS is present, run:
bash
bash "$SKILL_DIR/scripts/route-ai.sh" -- "$ARGUMENTS"

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results