Agent skill

OmniRoute Settings API

by diegosouzapw in diegosouzapw/OmniRoute

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

— description from SKILL.md by diegosouzapw
MITAuto-check passedAI & LLM Engineering

Install OmniRoute Settings API

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

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

GitHub CLI
$ gh skill install diegosouzapw/OmniRoute omni-settings --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-settings .claude/skills/omni-settings && 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-settings
GitHub stars
74k
Used in
1 other repo
Token cost
~3.6k tokens
SKILL.md length
399 words
Files
2 (incl. references)
Skills in repo
50
Repo updated
First seen
Licence
MIT

At a glance

  • SKILL.md covers Overview, Authentication, Endpoints and Payloads
  • Calls curl; needs REQUIRE_API_KEY and OMNIROUTE_TOKEN

About this skill

OmniRoute Settings API is a skill in diegosouzapw/OmniRoute (74k stars). Its SKILL.md is about 3.6k tokens, with 1 other file in the folder (references), and copies of it appear in 1 other owners' repositories. Licence: MIT.

What it can do on your machine

Read from SKILL.md and the folder at commit f8a8131. 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:

    • REQUIRE_API_KEY
    • OMNIROUTE_TOKEN

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

Context cost

OmniRoute Settings API loads about 3.6k tokens when it runs, and up to ~14k if it reads all its reference files. Until then it costs about 42 tokens; SKILL.md has 399 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~42
When it runs · the whole SKILL.md, loaded when a task matches
~3.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~14k

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 f8a8131, republished under its MIT licence (© diegosouzapw). 399 words, ~3,575 tokens.

Download SKILL.mdSave it as .claude/skills/omni-settings/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
omni-settings
description
Read and update global application settings: system prompts, thinking budget, IP filters, payload rules, combo defaults, and require-login configuration.
<!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten -->

Overview

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

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

Show full SKILL.md (104 more words)Show less

Payloads

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

<!-- skill:custom-start -->
<!-- Thinking budget behavior (preserved curated content — #10169) -->
GET /api/settings/thinking-budget — behavior

Returns proxy-level thinking/reasoning request rewrite settings:

FieldMeaning
modepassthrough (leave client reasoning alone — required for Codex visible thinking), auto (strips all client thinking fields), custom, adaptive
customBudgetFixed budget when mode=custom
effortLevelBase effort when mode=adaptive

Not compression and not "decrypt encrypted reasoning". Full guide: docs/guides/THINKING_BUDGET.md.

Example — keep client-controlled reasoning (Codex/Desktop):

bash
curl -X PUT https://localhost:20128/api/settings/thinking-budget \
  -H "Authorization: Bearer $OMNIROUTE_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"mode":"passthrough","customBudget":10240,"effortLevel":"medium"}'

Warning: mode=auto deletes reasoning / reasoning_effort / Claude thinking from the outbound body before upstream. That can empty thinking panels even when the client requested Ultra + summary.

<!-- 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

SKILL.md and 1 other file (references) in skills/omni-settings of diegosouzapw/OmniRoute.

  • SKILL.md
  • references/endpoints.md

Open the folder on GitHubat commit f8a8131

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in diegosouzapw/OmniRoute, which our catalogue first saw on October 7, 2026.

Compare with similar skills

OmniRoute Settings API 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 Settings API compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
OmniRoute Settings API this skilldiegosouzapw/OmniRoute74k1 repos~3.6kAutomated safety check: PassMIT
FreeRide Free Model ManagerShaivpidadi/FreeRide2383 repos~1.1kAutomated safety check: PassNone
Embeddings via 9Routerdecolua/9router30k—~604Automated safety check: PassMIT
Pixiu LLM Gatewayapache/dubbo-go-pixiu568—~2.5kAutomated safety check: PassApache-2.0
Using Ccproxy APIstarbaser/ccproxy350—~4kAutomated safety check: PassCustom licence
Caching Architecturemajiayu000/litellm-rs117—~2kAutomated safety check: PassMIT

Similar skills

  • FreeRide Free Model Manager

    Shaivpidadi/FreeRide

    Configures OpenClaw to use free OpenRouter models, setting the best one as primary and adding ranked fallbacks so rate limits do not interrupt work.

    238 GitHub starsUsed in 3 repos~1.1k tokens
    AI & LLM EngineeringAuto-check passed
  • Embeddings via 9Router

    decolua/9router

    Generates vector embeddings through the 9Router /v1/embeddings endpoint, using models from providers such as OpenAI, Gemini, Mistral and Voyage for RAG and semantic search.

    30k GitHub stars~604 tokensUpdated 8 days ago
    AI & LLM EngineeringAuto-check passed
  • Pixiu LLM Gateway

    apache/dubbo-go-pixiu

    Creates and validates dubbo-go-pixiu LLM gateway conf.yaml. An agent skill from apache/dubbo-go-pixiu.

    568 GitHub stars~2.5k tokensUpdated 5 days ago
    AI & LLM EngineeringAuto-check passed
  • Using Ccproxy API

    starbaser/ccproxy

    Guides users through ccproxy as an OpenAI-compatible and Anthropic-compatible LLM API server with SDK integration, OAuth authentication, sentinel key substitution, model routing, and troubleshooting.

    350 GitHub stars~4k tokensUpdated 2 mo ago
    AI & LLM EngineeringAuto-check passed
  • Caching Architecture

    majiayu000/litellm-rs

    LiteLLM-RS response caching architecture. An agent skill from majiayu000/litellm-rs.

    117 GitHub stars~2k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed
  • Streaming Architecture

    majiayu000/litellm-rs

    LiteLLM-RS Streaming Architecture. An agent skill from majiayu000/litellm-rs.

    117 GitHub stars~2.1k tokensUpdated yesterday
    AI & LLM EngineeringAuto-check passed

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.

    74k GitHub stars~948 tokensUpdated yesterday
    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.

    74k GitHub stars~748 tokensUpdated yesterday
    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.

    74k GitHub starsUsed in 1 repo~395 tokens
    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.

    74k GitHub stars~2.4k tokensUpdated yesterday
    Auto-check passed
  • OmniRoute Prompt Compression CLI

    diegosouzapw/OmniRoute

    Configure and test prompt compression from the CLI. Manage RTK filters, Caveman rules, stacked compression modes, and preview compression output with real…

    74k GitHub starsUsed in 1 repo~521 tokens
    Auto-check passed
  • OmniRoute Cost and Usage CLI

    diegosouzapw/OmniRoute

    View cost breakdowns, token usage, and call logs from the CLI. Filter by provider, model, or date range. Export usage reports and inspect per-connection…

    74k GitHub starsUsed in 1 repo~693 tokens
    Auto-check passed

Works with

Questions about OmniRoute Settings API

How do I install OmniRoute Settings API in Claude Code?

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

How do I install OmniRoute Settings API in Codex?

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

Can I use OmniRoute Settings API 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-settings -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-settings, .gemini/skills/omni-settings, .github/skills/omni-settings and .opencode/skills/omni-settings in your project.

What does OmniRoute Settings API need to run?

Going by SKILL.md and its folder, OmniRoute Settings API needs the command-line tools its instructions call (curl) and credentials named REQUIRE_API_KEY and OMNIROUTE_TOKEN.

Does OmniRoute Settings API 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 Settings API 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 Settings API use?

OmniRoute Settings API 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 Settings API use?

About 3.6k tokens (SKILL.md is roughly 14k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 10k tokens, read only when the agent opens those files.

What are the alternatives to OmniRoute Settings API?

Skills that share tags, products or a category with OmniRoute Settings API: FreeRide Free Model Manager (Shaivpidadi/FreeRide, 238 stars), Embeddings via 9Router (decolua/9router, 30k stars), Pixiu LLM Gateway (apache/dubbo-go-pixiu, 568 stars) and Using Ccproxy API (starbaser/ccproxy, 350 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains OmniRoute Settings API?

diegosouzapw (a GitHub user) maintains it in diegosouzapw/OmniRoute, which has 74,003 GitHub stars. The repository holds 50 skills in this directory. The repository was last updated on October 8, 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.