Agent skill

OmniRoute Health CLI

by diegosouzapw in diegosouzapw/OmniRoute

Checks OmniRoute server health, per-component status, and circuit breakers from the command line, with a live watch dashboard.

MITAuto-check passedDevOps & Cloud

Install OmniRoute Health CLI

skills CLI
$ npx skills add diegosouzapw/OmniRoute --skill cli-health -a claude-code

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

GitHub CLI
$ gh skill install diegosouzapw/OmniRoute cli-health --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/cli-health .claude/skills/cli-health && 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
cli-health
GitHub stars
74k
Used in
1 other repo
Token cost
~327 tokens
SKILL.md length
79 words
Files
1
Skills in repo
50
Repo updated
First seen
Licence
MIT

At a glance

Checks OmniRoute server health, per-component status, and circuit breakers from the command line, with a live watch dashboard.

  • Diagnosing why an OmniRoute instance seems unhealthy
  • SKILL.md covers Overview, Quick install and Subcommands
  • Calls npm
  • Watching provider circuit breakers during an incident

What it does

Four omniroute diagnostic commands get wrapped: doctor for a liveness check against a given host, health for an overall report with verbose and alerts-only modes, health components for a per-component breakdown, and health watch for a refreshing live dashboard of circuit breakers and provider status at a chosen interval. A plain status command gives a quick dashboard summary.

When your agent uses it

  • Diagnosing why an OmniRoute instance seems unhealthy
  • Watching provider circuit breakers during an incident
  • Running a quick liveness check against a specific host

Example prompts

  • “Run the doctor check against our staging OmniRoute host.”
  • “Watch component health every 5 seconds while I redeploy.”
  • “List only the components currently showing alerts.”

Requirements

  • OmniRoute CLI (`npm install -g omniroute`)

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:

    • npm

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

  • Network

    No URLs in SKILL.md. Its commands use npm, 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 no API keys, tokens, secrets or passwords.

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

Context cost

OmniRoute Health CLI loads about 327 tokens when it runs. Until then it costs about 50 tokens; SKILL.md has 79 words of instructions outside code blocks.

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

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). 79 words, ~327 tokens.

Download SKILL.mdSave it as .claude/skills/cli-health/SKILL.md (or your agent's skills folder).
name
cli-health
description
Check server health, component status, and live metrics from the CLI. Run `health`, `health components`, and `health watch` for a real-time dashboard of circuit breakers and provider status.
<!-- generated by src/lib/agentSkills/generator.ts; manual edits will be overwritten -->

Overview

Check server health, component status, and live metrics from the CLI. Run health, health components, and health watch for a real-time dashboard of circuit breakers and provider status.

Quick install

bash
npm install -g omniroute   # or: npx omniroute
omniroute --version

Subcommands

doctor

Flags:

  • --no-liveness
  • --host <host>
  • --liveness-url <url>

Example:

bash
omniroute doctor
health

Flags:

  • -v, --verbose
  • --json
  • --alerts-only

Example:

bash
omniroute health
health components

List health components and their status

Flags:

  • --alerts-only

Example:

bash
omniroute health components
health watch

Live dashboard — refresh every N seconds

Flags:

  • --interval <s>

Example:

bash
omniroute health watch
status

Show OmniRoute status dashboard

Flags:

  • -v, --verbose

Example:

bash
omniroute status

© 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/cli-health of diegosouzapw/OmniRoute.

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 Health CLI 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 Health CLI compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
OmniRoute Health CLI this skilldiegosouzapw/OmniRoute74k1 repos~327Automated safety check: PassMIT
Mz Release SignoffMaterializeInc/materialize6.4k—~7.2kAutomated safety check: PassCustom licence
Axiom Alerting Managementopenclaw/clawhub9.5k—~2.1kAutomated safety check: PassMIT
KubeEye Cluster Inspectionkubesphere/kubesphere17k—~3.6kAutomated safety check: PassCustom licence
Axiom Dashboard Builderopenclaw/clawhub9.5k—~4.9kAutomated safety check: PassMIT
Docs Corpus Auditmicrosoft/apm4k—~2.6kAutomated safety check: PassMIT

Similar skills

  • Mz Release Signoff

    MaterializeInc/materialize

    Verify a release candidate on the Grafana dashboards and sign off in release.

    6.4k GitHub stars~7.2k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Creates and manages Axiom monitors and notifiers end to end through the v2 API, with scripts for each CRUD operation and a recommended create-validate-tune workflow.

    9.5k GitHub stars~2.1k tokensUpdated today
    DevOps & CloudAuto-check passed
  • KubeEye Cluster Inspection

    kubesphere/kubesphere

    Deploys KubeEye on KubeSphere and writes InspectRule and InspectPlan resources to inspect cluster health, then retrieves the inspection reports.

    17k GitHub stars~3.6k tokensUpdated 2 mo ago
    DevOps & CloudAuto-check passed
  • Axiom Dashboard Builder

    openclaw/clawhub

    Designs and deploys Axiom dashboards through the API, choosing chart types and writing APL or metrics queries, with templates and migration notes for Splunk and Grafana.

    9.5k GitHub stars~4.9k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Docs Corpus Audit

    microsoft/apm

    Official

    A skill your agent uses to run a holistic regrounding pass on the entire microsoft/apm documentation corpus against current source code, page-by-page, and emit surgical fixes for stale claims.

    4k GitHub stars~2.6k tokensUpdated today
    DevOps & CloudAuto-check passed
  • Queries live Prometheus metrics and manages Grafana dashboards as code for Happy's infrastructure, using the grafanactl CLI and the Grafana datasource proxy API.

    24k GitHub stars~2k tokensUpdated yesterday
    DevOps & CloudAuto-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.

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

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

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

Categories

Questions about OmniRoute Health CLI

What does OmniRoute Health CLI do?

Checks OmniRoute server health, per-component status, and circuit breakers from the command line, with a live watch dashboard. Four omniroute diagnostic commands get wrapped: doctor for a liveness check against a given host, health for an overall report with verbose and alerts-only modes, health components for a per-component breakdown, and health watch for a refreshing live dashboard of circuit breakers and provider status at a chosen interval. A plain status command gives a quick dashboard summary.

When should I use OmniRoute Health CLI?

OmniRoute Health CLI fits situations like: diagnosing why an OmniRoute instance seems unhealthy; watching provider circuit breakers during an incident; running a quick liveness check against a specific host.

How do I install OmniRoute Health CLI in Claude Code?

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

How do I install OmniRoute Health CLI in Codex?

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

Can I use OmniRoute Health CLI 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 cli-health -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/cli-health, .gemini/skills/cli-health, .github/skills/cli-health and .opencode/skills/cli-health in your project.

What does OmniRoute Health CLI need to run?

Going by SKILL.md and its folder, OmniRoute Health CLI needs the command-line tools its instructions call (npm). Our summary lists: OmniRoute CLI (`npm install -g omniroute`).

Does OmniRoute Health CLI access the network?

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

Is OmniRoute Health CLI 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 Health CLI use?

OmniRoute Health CLI 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 Health CLI use?

About 327 tokens (SKILL.md is roughly 1.3k 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 Health CLI?

Skills that share tags, products or a category with OmniRoute Health CLI: Mz Release Signoff (MaterializeInc/materialize, 6.4k stars), Axiom Alerting Management (openclaw/clawhub, 9.5k stars), KubeEye Cluster Inspection (kubesphere/kubesphere, 17k stars) and Axiom Dashboard Builder (openclaw/clawhub, 9.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains OmniRoute Health CLI?

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.