| name | claude-router |
| description | 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. |
| user-invocable | true |
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.
When NOT to Use
-
Interactive code review or task hand-off from this Claude Code session → use the /codex:* plugin commands directly (/codex:review, /codex:adversarial-review, /codex:rescue, /codex:status). The router is for programmatic delegation from scripts, cron, and bridges — it goes through the claude-codex skill's bash wrapper, not the plugin.
If you don't see /codex:* slash-commands, install the plugin via the 4 commands documented in skills/claude-codex/SKILL.md ("When NOT to Use" section).
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 "$SKILL_DIR/scripts/route-ai.sh" --check
Common Commands
bash "$SKILL_DIR/scripts/route-ai.sh" -- "Review the current diff for regressions"
bash "$SKILL_DIR/scripts/route-ai.sh" --engine codex -- "Inspect src/task-bridge.ts for races"
bash "$SKILL_DIR/scripts/route-ai.sh" --engine gemini -- "Trace task flow across the entire repo"
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 "$SKILL_DIR/scripts/route-ai.sh" -- "$ARGUMENTS"