cli-routing — Claude Code skill: what it does, how to install
Manage model routing combos from the command line with omniroute. Test routing strategies, inspect metrics, and configure fallback chains interactively.
npx skills add cheaper-inference/OmniRoute --skill cli-routing -a claude-codeWhat cli-routing does
The skill provides agent instructions to run omniroute CLI commands for model routing. It helps test routing strategies and switch active model combos directly in the terminal interface.
Under the hood, it interacts with several subcommands. The suggest command finds paths based on task descriptions, latency limits, and cost targets. Combos are managed with combo create, combo switch, combo delete, and listed via combo list with optional JSON formatting.
The skill depends on the external omniroute package, so you must install it globally with npm or execute it via npx. Without the CLI binary available in your environment, routing commands fail.
What it helps with
- find optimal model routes with the
suggestcommand - create custom model combos using
combo create - switch active routing presets via
combo switch - configure interactive fallback chains for model calls
Example prompts for the agent
- Find a route for this task using `omniroute suggest --explain`.
- Create a new combo with `omniroute combo create fast-path --models spec`.
- List all configured routing combos in JSON using `omniroute combo list --json`.
How to install cli-routing
1Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill cli-routing -a claude-code2Manually: put the files in place
~/.claude/skills/cli-routing/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/cli-routing/
1Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill cli-routing -a codex2Manually: put the files in place
.agents/skills/cli-routing/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill cli-routing -a cursor2Manually: put the files in place
.cursor/skills/cli-routing/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install cheaper-inference/OmniRoute cli-routing2Manually: put the files in place
.github/skills/cli-routing/SKILL.md1Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill cli-routing -a gemini-cli2Platform CLI
gemini skills install https://github.com/cheaper-inference/OmniRoute --path skills/cli-routingManually: put the files in place
.devin/skills/cli-routing/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill cli-routing -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set34
The whole set →Similar
Questions about cli-routing
How to install cli-routing in Claude Code?
Run npx skills add cheaper-inference/OmniRoute --skill cli-routing -a claude-code in your terminal to install the skill.
What does cli-routing do?
It lets your agent configure model routing combos, test routing rules, inspect metrics, and switch active chains from the command line.
What is required before using cli-routing?
You need the omniroute package installed globally via npm install -g omniroute or accessible through npx omniroute.
Source text
SKILL.md · MIT
--- name: cli-routing description: Create, list, update, and delete routing combos from the CLI. Test routing strategies, inspect combo metrics, and configure fallback chains interactively. --- <!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten --> ## Overview Create, list, update, and delete routing combos from the CLI. Test routing strategies, inspect combo metrics, and configure fallback chains interactively. ## Quick install ```bash npm install -g omniroute # or: npx omniroute omniroute --version ``` ## Subcommands ### `suggest` **Flags:** - `--task <description>` - `--max-cost <usd>` - `--max-latency-ms <ms>` - `--weights <json>` - `--top <n>` - `--explain` - `--switch` **Example:** ```bash omniroute suggest ``` ### `combo combo` **Example:** ```bash omniroute combo combo ``` ### `combo list` List configured routing combos **Flags:** - `--json` **Example:** ```bash omniroute combo list ``` ### `combo switch <name>` Activate a routing combo **Example:** ```bash omniroute combo switch <name> ``` ### `combo create <name>` Create a new routing combo **Flags:** - `--models <spec>` - `--model <spec>` **Example:** ```bash omniroute combo create <name> ``` ### `combo delete <name>` Delete a routing combo **Flags:** - `--yes` **Example:** ```bash omniroute combo delete <name> ```
© cheaper-inference · MIT · cheaper-inference/OmniRoute