Agent skill

OmniRoute Combo Routing

by diegosouzapw in diegosouzapw/OmniRoute

Manages OmniRoute routing combos through its REST API: create and update combos, choose from 19 strategies, set fallback chains, test outcomes and read metrics.

MITAuto-check passedBackend & APIs

Install OmniRoute Combo Routing

skills CLI
$ npx skills add diegosouzapw/OmniRoute --skill omni-combos-routing -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install diegosouzapw/OmniRoute omni-combos-routing --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/diegosouzapw/OmniRoute.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/omni-combos-routing .claude/skills/omni-combos-routing && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
omni-combos-routing
GitHub stars
75k
Token cost
~2.1k tokens
SKILL.md length
514 words
Files
1
Skills in repo
50
Repo updated
First seen
Licence
MIT

At a glance

Manages OmniRoute routing combos through its REST API: create and update combos, choose from 19 strategies, set fallback chains, test outcomes and read metrics.

  • Creating a weighted or round-robin routing combo across several providers
  • SKILL.md covers Overview, Authentication, Endpoints and Payloads, plus 10 more sections
  • Calls curl; needs OMNIROUTE_TOKEN and OMNIROUTE_KEY
  • Setting up a fallback chain so traffic moves to another model on failure

What it does

A reference for the combo endpoints of an OmniRoute AI gateway. You can list, create, read, update and delete routing combos, and 19 strategies are available, including priority, weighted, round-robin and Auto-combo. Updates through PUT or PATCH are partial: omitted fields keep their stored value, while an array that is sent replaces the stored one outright.

Separate endpoints test a combo configuration and return combo metrics, and others list or create the fallback chains used for model routing. Every call needs a Bearer token or a session cookie, which comes from the login endpoint, unless REQUIRE_API_KEY is set to false for local development.

When your agent uses it

  • Creating a weighted or round-robin routing combo across several providers
  • Setting up a fallback chain so traffic moves to another model on failure
  • Testing a combo configuration before relying on it
  • Reading combo metrics to see how routing is performing

Example prompts

  • “Create a round-robin combo across my Claude and Gemini providers.”
  • “Add a fallback chain that drops to a cheaper model when the first one fails.”
  • “Test the new combo and pull its metrics.”

Requirements

  • A running OmniRoute instance
  • A Bearer token or session cookie, or REQUIRE_API_KEY=false locally

What it can do on your machine

Read from SKILL.md and the folder at commit 7510677. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use curl, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • OMNIROUTE_TOKEN
    • OMNIROUTE_KEY
    • REQUIRE_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

OmniRoute Combo Routing loads about 2.1k tokens when it runs. Until then it costs about 52 tokens; SKILL.md has 514 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~52
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from diegosouzapw/OmniRoute at commit 7510677, republished under its MIT licence (© diegosouzapw). 514 words, ~2,136 tokens.

Download SKILL.mdSave it as .claude/skills/omni-combos-routing/SKILL.md (or your agent's skills folder).
name
omni-combos-routing
description
Create and manage routing combos with 19 strategies (priority, weighted, round-robin, Auto-combo, and more). Configure fallback chains, test routing outcomes, and retrieve combo metrics.
<!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten -->

Overview

Create and manage routing combos with 19 strategies (priority, weighted, round-robin, Auto-combo, and more). Configure fallback chains, test routing outcomes, and retrieve combo metrics.

Authentication

All requests require a valid Bearer token or session cookie. Obtain a token via POST /api/auth/login or configure REQUIRE_API_KEY=false for local development.

Endpoints

GET /api/combos

List routing combos

bash
curl https://localhost:20128/api/combos \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
POST /api/combos

Create routing combo

bash
curl -X POST https://localhost:20128/api/combos \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
GET /api/combos/{id}

Get combo by ID

bash
curl https://localhost:20128/api/combos/{id} \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
PUT /api/combos/{id}

Update combo

Partial update: the body is merged onto the stored combo, so a field left out keeps its current value. An array that IS sent replaces the stored one outright.

bash
curl -X PUT https://localhost:20128/api/combos/{id} \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
PATCH /api/combos/{id}

Update combo

Partial update: the body is merged onto the stored combo, so a field left out keeps its current value. An array that IS sent replaces the stored one outright.

bash
curl -X PATCH https://localhost:20128/api/combos/{id} \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
DELETE /api/combos/{id}

Delete combo

bash
curl -X DELETE https://localhost:20128/api/combos/{id} \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
GET /api/combos/metrics

Get combo metrics

bash
curl https://localhost:20128/api/combos/metrics \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
POST /api/combos/test

Test a combo configuration

bash
curl -X POST https://localhost:20128/api/combos/test \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
GET /api/fallback/chains

List fallback chains

Returns all registered fallback chains for model routing.

bash
curl https://localhost:20128/api/fallback/chains \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
POST /api/fallback/chains

Create fallback chain

Registers a fallback routing chain for a model.

bash
curl -X POST https://localhost:20128/api/fallback/chains \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
DELETE /api/fallback/chains

Delete fallback chain

bash
curl -X DELETE https://localhost:20128/api/fallback/chains \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
GET /api/combos/auto

GET combos › auto

bash
curl https://localhost:20128/api/combos/auto \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
GET /api/combos/builder/options

GET combos › builder › options

bash
curl https://localhost:20128/api/combos/builder/options \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN"
POST /api/combos/duplicate

POST combos › duplicate

bash
curl -X POST https://localhost:20128/api/combos/duplicate \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'
POST /api/combos/reorder

POST combos › reorder

bash
curl -X POST https://localhost:20128/api/combos/reorder \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

Payloads

See the full OpenAPI specification at GET /api/openapi/spec or docs/openapi.yaml for detailed request/response schemas.

<!-- skill:custom-start -->
<!-- Migrated from skills/omniroute-routing/SKILL.md (preserved curated content) -->

OmniRoute — Routing & Combos

Requires OMNIROUTE_URL and OMNIROUTE_KEY. See entry-point SKILL for setup.

What is a combo?

A combo is a named group of providers/models with a routing strategy. All requests through a combo are automatically distributed, failed-over, and load-balanced — the caller uses a single model ID like my-combo.

List existing combos

bash
curl $OMNIROUTE_URL/api/combos \
  -H "Authorization: Bearer $OMNIROUTE_KEY"

Response includes id, name, strategy, enabled, and per-target stats.

Create a combo

bash
curl -X POST $OMNIROUTE_URL/api/combos \
  -H "Authorization: Bearer $OMNIROUTE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "my-combo",
    "strategy": "priority",
    "targets": [
      { "provider": "anthropic", "model": "claude-opus-4-7", "weight": 1 },
      { "provider": "openai",    "model": "gpt-4o",           "weight": 1 }
    ]
  }'
Show full SKILL.md (239 more words)Show less

19 public routing strategies

StrategyDescription
priorityAlways use target[0]; fall back on error
weightedDistribute by weight percentage
round-robinRotate targets in order
context-relayChain models for very long contexts
fill-firstFill quota of target[0] before spilling
p2cPower-of-two choices: sample two targets, pick the better candidate
randomUniform random selection
least-usedRoute to the target with the lowest observed usage
cost-optimizedPick the cheapest eligible target for the token estimate
reset-awarePrefer targets based on quota-reset state
reset-windowOrder targets by their configured reset window
headroomPrefer targets with more remaining quota headroom
strict-randomRandom without repeating until all targets have been used
autoAuto-Combo scoring across 16 factors
lkgpLast-known-good-provider sticky routing
context-optimizedPick the best model for the request's context size
cache-optimizedPrefer targets with stronger cache affinity
fusionRun a panel in parallel and synthesize one judged response
pipelineRun a configured sequence of targets as a pipeline

Auto-combo scores each candidate on 16 factors every request:

bash
curl -X POST $OMNIROUTE_URL/api/combos \
  -H "Authorization: Bearer $OMNIROUTE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "prod-auto",
    "strategy": "auto",
    "targets": [
      { "provider": "anthropic", "model": "claude-sonnet-4-6" },
      { "provider": "openai",    "model": "gpt-4o-mini" },
      { "provider": "google",    "model": "gemini-2.0-flash" }
    ]
  }'

Then call it with:

bash
curl -X POST $OMNIROUTE_URL/v1/chat/completions \
  -H "Authorization: Bearer $OMNIROUTE_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "model": "prod-auto", "messages": [{ "role": "user", "content": "Hello" }] }'

Activate / deactivate a combo

bash
# Activate
curl -X PUT $OMNIROUTE_URL/api/combos/{id}/toggle \
  -H "Authorization: Bearer $OMNIROUTE_KEY" \
  -d '{ "enabled": true }'

Get combo metrics

bash
curl $OMNIROUTE_URL/api/combos/{id}/metrics \
  -H "Authorization: Bearer $OMNIROUTE_KEY"

Returns p50/p95/p99 latency, success rate, cost, and per-target breakdown.

Simulate routing (dry run)

bash
curl -X POST $OMNIROUTE_URL/api/routing/simulate \
  -H "Authorization: Bearer $OMNIROUTE_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "comboId": "{id}", "messages": [{ "role": "user", "content": "test" }] }'

Returns which provider would be selected and why — no actual API call is made.

Via MCP (if OmniRoute is your MCP server)

omniroute_list_combos     → list all combos
omniroute_switch_combo    → enable/disable a combo
omniroute_set_routing_strategy → change strategy at runtime
omniroute_simulate_route  → dry-run routing decision
omniroute_best_combo_for_task → get recommendation by task type

Errors

  • 404 combo not found → check id from /api/combos
  • 400 invalid strategy → use one of the 19 strategies above
  • 409 name conflict → combo name already exists
<!-- skill:custom-end -->

© diegosouzapw, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/omni-combos-routing of diegosouzapw/OmniRoute.

Open the folder on GitHubat commit 7510677

Compare with similar skills

OmniRoute Combo Routing next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

OmniRoute Combo Routing compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
OmniRoute Combo Routing this skilldiegosouzapw/OmniRoute75k—~2.1kAutomated safety check: PassMIT
Session Manager Driverbobmatnyc/claude-mpm156—~3.9kAutomated safety check: PassElastic-2.0
BankrBankrBot/skills1.2k—~5.3kAutomated safety check: PassNone
OpenAPI to MCP Servermcp-use/mcp-use11k—~5.2kAutomated safety check: PassApache-2.0
Databuddydatabuddy-analytics/Databuddy1.2k—~2.1kAutomated safety check: PassAGPL-3.0
Neo4j Aura Agent Skillneo4j-contrib/neo4j-skills114—~4.4kAutomated safety check: NotesMIT

Similar skills

  • Session Manager Driver

    bobmatnyc/claude-mpm

    Drive the trusty-mpm session manager (binary tm) to spawn, observe, command, and decommission durable tmux-backed Claude Code sessions in isolated workspaces.

    156 GitHub stars~3.9k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed
  • Bankr

    BankrBot/skills

    Bankr is an AI crypto agent with its own wallets, a direct Wallet API and a pay-as-you-go LLM gateway, driven by the bankr CLI or the REST API.

    1.2k GitHub stars~5.3k tokensUpdated today
    Backend & APIsAuto-check passed
  • OpenAPI to MCP Server

    mcp-use/mcp-use

    Turns an OpenAPI or Swagger spec into an MCP server with the mcp-use TypeScript SDK, mapping each operation to a tool, wiring auth, testing and deploying.

    11k GitHub stars~5.2k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Databuddy

    databuddy-analytics/Databuddy

    Integrate Databuddy analytics using the SDK, REST API, or MCP.

    1.2k GitHub stars~2.1k tokensUpdated today
    Backend & APIsAuto-check passed
  • Neo4j Aura Agent Skill

    neo4j-contrib/neo4j-skills

    Manages Neo4j Aura Agents via the v2beta1 REST API — create, list, get, update, delete, and invoke Aura agents backed by an AuraDB instance.

    114 GitHub stars~4.4k tokensUpdated today
    Backend & APIsAuto-check: notes
  • Cognee Local Server Setup

    topoteretes/cognee

    Starts the cognee API server and web UI on your own machine, checks its health, connects the SDK or CLI to it and helps you pick between multi-tenant and single-user auth.

    32k GitHub stars~702 tokensUpdated today
    Backend & APIsAuto-check: notes

More from diegosouzapw/OmniRoute

All 50 skills in this repo
  • OmniRoute Backup and Sync CLI

    diegosouzapw/OmniRoute

    Backup and restore OmniRoute data from the CLI. Trigger incremental snapshots, sync to cloud storage, manage backup schedules, and restore from archive files.

    75k GitHub stars~948 tokensUpdated today
    Auto-check passed
  • Quality Scan

    diegosouzapw/OmniRoute

    Runs a scoped, read-only quality scan on a repository candidate and reports exact evidence, failures and frozen debt, without treating a static scan as release acceptance.

    75k GitHub stars~748 tokensUpdated today
    Auto-check passed
  • OmniRoute Provider Management

    diegosouzapw/OmniRoute

    Manages AI provider connections, API keys, OAuth flows and connection tests through OmniRoute's REST API across its 327-provider catalog.

    75k GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • OmniRoute Settings API

    diegosouzapw/OmniRoute

    Read and update global application settings: system prompts, thinking budget, IP filters, payload rules, combo defaults, and require-login configuration.

    75k GitHub stars~3.6k tokensUpdated today
    Auto-check passed
  • OmniRoute Database Backups

    diegosouzapw/OmniRoute

    Trigger system backups, restore from backup files, and manage the SQLite database lifecycle. Supports export, import, and incremental snapshot strategies.

    75k GitHub stars~395 tokensUpdated today
    Auto-check passed
  • OmniRoute Batch CLI

    diegosouzapw/OmniRoute

    Submit and monitor batch inference jobs from the CLI. Upload and manage files for batch processing, retrieve results, and integrate batch pipelines with CI/CD…

    75k GitHub stars~565 tokensUpdated today
    Auto-check passed

Questions about OmniRoute Combo Routing

What does OmniRoute Combo Routing do?

Manages OmniRoute routing combos through its REST API: create and update combos, choose from 19 strategies, set fallback chains, test outcomes and read metrics. A reference for the combo endpoints of an OmniRoute AI gateway. You can list, create, read, update and delete routing combos, and 19 strategies are available, including priority, weighted, round-robin and Auto-combo.

When should I use OmniRoute Combo Routing?

OmniRoute Combo Routing fits situations like: creating a weighted or round-robin routing combo across several providers; setting up a fallback chain so traffic moves to another model on failure; testing a combo configuration before relying on it; reading combo metrics to see how routing is performing.

How do I install OmniRoute Combo Routing in Claude Code?

Run `npx skills add diegosouzapw/OmniRoute --skill omni-combos-routing -a claude-code`. Or copy the skill folder (skills/omni-combos-routing in diegosouzapw/OmniRoute) into .claude/skills/omni-combos-routing in your project. Claude Code loads it when a task matches its description.

How do I install OmniRoute Combo Routing in Codex?

Run `npx skills add diegosouzapw/OmniRoute --skill omni-combos-routing -a codex`. Or copy the skill folder (skills/omni-combos-routing in diegosouzapw/OmniRoute) into .agents/skills/omni-combos-routing in your project. Codex loads it when a task matches its description.

Can I use OmniRoute Combo Routing in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add diegosouzapw/OmniRoute --skill omni-combos-routing -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/omni-combos-routing, .gemini/skills/omni-combos-routing, .github/skills/omni-combos-routing and .opencode/skills/omni-combos-routing in your project.

What does OmniRoute Combo Routing need to run?

Going by SKILL.md and its folder, OmniRoute Combo Routing needs the command-line tools its instructions call (curl) and credentials named OMNIROUTE_TOKEN, OMNIROUTE_KEY and REQUIRE_API_KEY. Our summary lists: A running OmniRoute instance; A Bearer token or session cookie, or REQUIRE_API_KEY=false locally.

Does OmniRoute Combo Routing access the network?

SKILL.md contains no URLs. Its commands use curl, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is OmniRoute Combo Routing safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does OmniRoute Combo Routing use?

OmniRoute Combo Routing is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does OmniRoute Combo Routing use?

About 2.1k tokens (SKILL.md is roughly 8.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to OmniRoute Combo Routing?

Skills that share tags, products or a category with OmniRoute Combo Routing: Session Manager Driver (bobmatnyc/claude-mpm, 156 stars), Bankr (BankrBot/skills, 1.2k stars), OpenAPI to MCP Server (mcp-use/mcp-use, 11k stars) and Databuddy (databuddy-analytics/Databuddy, 1.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains OmniRoute Combo Routing?

diegosouzapw (a GitHub user) maintains it in diegosouzapw/OmniRoute, which has 74,749 GitHub stars. The repository holds 50 skills in this directory. The repository was last updated on October 10, 2026.

Source: diegosouzapw/OmniRoute on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.