cli-resilience — Claude Code skill: what it does, how to install
A skill that hands the agent the OmniRoute CLI commands for breaker state, cooldowns and quota checks, so a stuck provider can be reset from the terminal.
npx skills add cheaper-inference/OmniRoute --skill cli-resilience -a claude-codeWhat cli-resilience does
The skill gives the agent a map of OmniRoute's own CLI, so it stops guessing which subcommand shows breaker state, connection cooldowns, model lockouts or quota numbers. Two groups are covered, resilience and quota, each with its flags and an example call.
resilience status and breakers report what is tripped; cooldowns and lockouts narrow the view with --provider, --connection-id and --model. resilience reset clears one provider, connection or model, while --all-cooldowns with --yes wipes every cooldown without a confirmation prompt. resilience set takes --threshold, --reset-timeout and --base-cooldown in milliseconds. For quotas, quota status prints gateway, pool and circuit state, and quota preview runs an allocation check through --api-key-id, --pool-id and --tokens before any upstream call.
None of it works without the CLI, so the instructions open with npm install -g omniroute or npx omniroute, then omniroute --version. One caveat worth knowing: the skill file is generated and manual edits get overwritten, so keeping your own thresholds on the command line beats editing the file. quota ensure <json> wants a JSON object as its argument.
What it helps with
- see which provider is stuck in backoff
- clear a cooldown on one connection
- check whether a request fits the quota before sending it
- dump quota state as JSON for a script
- create or update a quota pool from a JSON object
Example prompts for the agent
- Show me what is tripped right now: `omniroute resilience breakers`
- Clear every cooldown without asking: `omniroute resilience reset --all-cooldowns --yes`
- Preview the allocation for `--tokens <n>` before I send the request: `omniroute quota preview`
How to install cli-resilience
1Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill cli-resilience -a claude-code2Manually: put the files in place
~/.claude/skills/cli-resilience/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/cli-resilience/
1Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill cli-resilience -a codex2Manually: put the files in place
.agents/skills/cli-resilience/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill cli-resilience -a cursor2Manually: put the files in place
.cursor/skills/cli-resilience/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install cheaper-inference/OmniRoute cli-resilience2Manually: put the files in place
.github/skills/cli-resilience/SKILL.md1Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill cli-resilience -a gemini-cli2Platform CLI
gemini skills install https://github.com/cheaper-inference/OmniRoute --path skills/cli-resilienceManually: put the files in place
.devin/skills/cli-resilience/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add cheaper-inference/OmniRoute --skill cli-resilience -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set34
The whole set →Similar
Questions about cli-resilience
How do I install cli-resilience in Claude Code?
Run npx skills add cheaper-inference/OmniRoute --skill cli-resilience -a claude-code. The skill lands at ~/.claude/skills/cli-resilience/SKILL.md.
What does cli-resilience do?
It tells the agent which OmniRoute subcommands inspect breakers, cooldowns, lockouts and quotas, and which ones reset a stuck provider or change resilience thresholds.
Do I need OmniRoute installed first?
Yes. Install it with npm install -g omniroute or run npx omniroute, then confirm with omniroute --version.
Source text
SKILL.md · MIT
--- name: cli-resilience description: Inspect and manage circuit-breaker states, connection cooldowns, quota limits, and backoff levels from the CLI. Reset stuck providers and configure resilience thresholds. --- <!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten --> ## Overview Inspect and manage circuit-breaker states, connection cooldowns, quota limits, and backoff levels from the CLI. Reset stuck providers and configure resilience thresholds. ## Quick install ```bash npm install -g omniroute # or: npx omniroute omniroute --version ``` ## Subcommands ### `quota` **Flags:** - `--provider <id>` - `--json` **Example:** ```bash omniroute quota ``` ### `quota status` Show truthful OmniRoute gateway, quota, pool, and circuit state **Example:** ```bash omniroute quota status ``` ### `quota preview` Preview allocation enforcement without an upstream request **Flags:** - `--api-key-id <id>` - `--pool-id <id>` - `--tokens <n>` **Example:** ```bash omniroute quota preview ``` ### `quota ensure <json>` Idempotently create or update a quota pool from a JSON object **Example:** ```bash omniroute quota ensure <json> ``` ### `resilience` **Example:** ```bash omniroute resilience ``` ### `resilience status` **Flags:** - `--provider <p>` **Example:** ```bash omniroute resilience status ``` ### `resilience breakers` **Flags:** - `--provider <p>` **Example:** ```bash omniroute resilience breakers ``` ### `resilience cooldowns` **Flags:** - `--provider <p>` - `--connection-id <id>` **Example:** ```bash omniroute resilience cooldowns ``` ### `resilience lockouts` **Flags:** - `--provider <p>` - `--model <m>` **Example:** ```bash omniroute resilience lockouts ``` ### `resilience reset` **Flags:** - `--provider <p>` - `--connection-id <id>` - `--model <m>` - `--all-cooldowns` - `--yes` **Example:** ```bash omniroute resilience reset ``` ### `resilience profile` **Example:** ```bash omniroute resilience profile ``` ### `resilience show` **Example:** ```bash omniroute resilience show ``` ### `resilience set <name>` **Example:** ```bash omniroute resilience set <name> ``` ### `resilience config` **Example:** ```bash omniroute resilience config ``` ### `resilience show` **Example:** ```bash omniroute resilience show ``` ### `resilience set` **Flags:** - `--threshold <n>` - `--reset-timeout <ms>` - `--base-cooldown <ms>` **Example:** ```bash omniroute resilience set ```
© cheaper-inference · MIT · cheaper-inference/OmniRoute