cli-models — Claude Code skill: browse the model catalog from CLI
A skill that lets the agent query the Anthropic model catalog from the command line: search, filter by provider, add and edit entries.
npx skills add cheaper-inference/OmniRoute --skill cli-models -a claude-codeWhat cli-models does
The cli-models skill exposes the omniroute models subcommands to your agent. Through them you can list available models, narrow the list by provider, search by name, and sort out spelling variants of model names.
Inside is a set of subcommands. models [provider] prints the catalog, with --search <query> and --json to shape the output. models manual <provider> shows manual model metadata. models add <provider> <model-id> adds a model without verification, models edit changes metadata, models remove drops a manual override. Then there is models test-add <model>: it validates an OpenAI-compatible model on one strict connection and adds it after a synthetic tool round-trip. Most commands take --dry-run, and test-add also takes --yes.
The skill runs on top of the omniroute CLI, so the package comes first: npm install -g omniroute or npx omniroute. Without omniroute installed the skill's commands will not run at all. It earns its place if you already keep a model catalog in Anthropic and would rather drive it through the agent than by hand.
What it helps with
- list available models for a given provider
- find a model by name or capability with search
- add an OpenAI-compatible model after validating the connection
- edit manual model metadata and confirm it persisted
- remove a manual model override
Example prompts for the agent
- List the Anthropic model catalog for
example-provider - Search the catalog for a model by name with
--search - Validate
example-modelwithomniroute models test-addand--dry-run
How to install cli-models
1Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill cli-models -a claude-code2Manually: put the files in place
~/.claude/skills/cli-models/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/cli-models/
1Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill cli-models -a codex2Manually: put the files in place
.agents/skills/cli-models/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill cli-models -a cursor2Manually: put the files in place
.cursor/skills/cli-models/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install cheaper-inference/OmniRoute cli-models2Manually: put the files in place
.github/skills/cli-models/SKILL.md1Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill cli-models -a gemini-cli2Platform CLI
gemini skills install https://github.com/cheaper-inference/OmniRoute --path skills/cli-modelsManually: put the files in place
.devin/skills/cli-models/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill cli-models -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about cli-models
How do I install cli-models in Claude Code?
Run npx skills add cheaper-inference/OmniRoute --skill cli-models -a claude-code. The skill lands in ~/.claude/skills/cli-models/SKILL.md.
What does cli-models do?
It gives the agent the omniroute models subcommands: browsing the catalog, filtering by provider, searching, adding and editing models, and removing manual overrides.
What do I need for the skill to work?
The omniroute CLI installed via npm install -g omniroute or run with npx omniroute. The skill's commands call into it.
Source text
SKILL.md · MIT
--- name: cli-models description: Query available AI models, list model aliases, and browse the full model catalog from the CLI. Filter by provider, search by capability, and resolve model name variants. --- <!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten --> ## Overview Query available AI models, list model aliases, and browse the full model catalog from the CLI. Filter by provider, search by capability, and resolve model name variants. ## Quick install ```bash npm install -g omniroute # or: npx omniroute omniroute --version ``` ## Subcommands ### `models test-add <model>` Validate an OpenAI-compatible model on one strict connection, then add it after a synthetic tool round-trip **Flags:** - `--provider <id>` - `--connection <id>` - `--name <name>` - `--max-input-tokens <count>` - `--max-output-tokens <count>` - `--api-format <format>` - `--context <name>` - `--base-url <url>` - `--allow-inference` - `--yes` - `--dry-run` - `--json` **Example:** ```bash omniroute models test-add example-model --provider example-provider --connection example-connection --dry-run ``` ### `models [provider]` **Flags:** - `--search <query>` - `--json` **Example:** ```bash omniroute models [provider] ``` ### `models manual <provider>` List manual model metadata from the selected server **Example:** ```bash omniroute models manual <provider> ``` ### `models add <provider> <model-id>` Add an unverified manual model, then verify persistence **Flags:** - `--name <name>` - `--api-format <format>` - `--context-window <tokens>` - `--max-output-tokens <tokens>` - `--dry-run` **Example:** ```bash omniroute models add <provider> <model-id> ``` ### `models edit <provider> <model-id>` Edit manual model metadata, then verify persistence **Flags:** - `--name <name>` - `--api-format <format>` - `--context-window <tokens>` - `--clear-context-window` - `--dry-run` **Example:** ```bash omniroute models edit <provider> <model-id> ``` ### `models remove <provider> <model-id>` Remove only a manual model override, then verify persistence **Flags:** - `--yes` - `--dry-run` **Example:** ```bash omniroute models remove <provider> <model-id> ```
© cheaper-inference · MIT · cheaper-inference/OmniRoute
