CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

omni-resilience

Monitor provider health, circuit-breaker states, p50/p95/p99 latency metrics, and budget guard alerts. Inspect connection cooldowns and model lockouts in real time.

Quality

72%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./skills/omni-resilience/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A highly actionable reference — copy-ready curl commands, a complete budget-guard example, and useful error-recovery guidance — undermined by a structural flaw: a generated half and a migrated half describe the same endpoints with conflicting paths and auth schemes. Resolving the conflicts and merging the duplicated sections would improve conciseness and navigation significantly.

Suggestions

Deduplicate the two halves: the generated section ("GET /api/monitoring/health", "GET /api/provider-metrics") and the migrated section ("System health", "Per-provider metrics") document the same operations with different paths — keep one authoritative endpoint per operation.

Reconcile the authentication guidance: one section says Bearer token via `POST /api/auth/login` or `REQUIRE_API_KEY=false` with `http://localhost:20128` and `$OMNIROUTE_TOKEN`, while the other requires `OMNIROUTE_URL` and `OMNIROUTE_KEY`; pick a single env-var scheme and use it consistently in every curl example.

Replace the dangling references (external raw.githubusercontent auth link, `docs/openapi.yaml` which is not part of the bundle) with a short inline auth snippet and inline schema highlights, or add real reference files so progressive disclosure has a target.

DimensionReasoningScore

Conciseness

Each section is tight — curl command, response shape, one-line purpose, no explanations of concepts Claude already knows — but the document documents the same concerns twice: the generated half ("GET /api/monitoring/health", "GET /api/provider-metrics") duplicates the migrated half ("System health", "Per-provider metrics"), and there are two separate auth sections. Merging the halves would remove roughly half the body without losing information. Not 2 because most content is essential and well compressed; not 4 because the duplication is more than a minor trim.

3 / 5

Actionability

Nearly everything is executable: concrete curl commands with headers, a full budget-guard POST payload with all `action` options, a JSON response example for provider metrics, named MCP tools, and an error-to-action table ("503 → retry in 5s", "OPEN → check resetAt"). Falls short of 5 because the two halves conflict — `/api/provider-metrics` vs `/api/providers/metrics`, `http://localhost:20128` + `$OMNIROUTE_TOKEN` vs `$OMNIROUTE_URL` + `$OMNIROUTE_KEY` — so a copy-pasted command may fail depending on which half is trusted.

4 / 5

Workflow Clarity

This is a read-only monitoring skill with no destructive or batch operations, and each task (health check, circuit-breaker inspection, metrics, quota, budget guard) is presented with its exact command and expected response; the Errors section supplies recovery checkpoints. Not 5 because a diagnostic sequence (check health → inspect circuit breaker → read resetAt → wait/probe) is left implicit and the conflicting duplicate endpoints create ambiguity about which command to run.

4 / 5

Progressive Disclosure

Section headers per topic are good and payload detail is delegated to "the full OpenAPI specification at `GET /api/openapi/spec` or `docs/openapi.yaml`", but no bundle files exist to back that pointer, the auth setup is offloaded to an external raw.githubusercontent URL, and ~160 lines of inline API catalog (duplicated across two halves) is content that belongs in consolidated, clearly-signaled sections or reference files. Not 4 because the duplication and unresolvable references are more than minor organization gaps.

3 / 5

Total

14

/

20

Passed

Description

66%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A specific, third-person description with strong domain keywords, but it never states when the skill should be used, which caps completeness and weakens trigger behavior. Adding a "Use when..." clause covering monitoring/quota/budget scenarios would lift it to the top band.

Suggestions

Add an explicit trigger clause, e.g. "Use when checking OmniRoute provider status, diagnosing circuit-breaker trips, latency regressions, quota limits, or budget guard alerts."

Mention remaining capabilities from the body (quota checks, budget guard configuration with degrade/block/alert actions) so the description's coverage matches the skill.

Include one or two natural synonym phrases users would actually say ("provider status", "spend limit", "uptime") to improve trigger recall.

DimensionReasoningScore

Specificity

Lists several concrete actions — "Monitor provider health, circuit-breaker states, p50/p95/p99 latency metrics, and budget guard alerts" plus "Inspect connection cooldowns and model lockouts" — in third person. Falls short of 5 because capabilities present in the body (quota checks, budget guard configuration, MCP tool access) are omitted from the description.

4 / 5

Completeness

The "what" is clear and multi-part, but there is no "Use when..." clause or equivalent explicit trigger guidance — the second sentence ("Inspect connection cooldowns and model lockouts in real time") extends the what rather than answering when. Per the judging guideline, a missing trigger clause caps completeness at 3.

3 / 5

Trigger Term Quality

Contains good natural keywords users would say: "provider health", "circuit-breaker", "p50/p95/p99 latency", "budget guard", "model lockouts". Not 5 because common variations like "quota", "uptime", "spend limit", "rate limits", and "status" are missing.

4 / 5

Distinctiveness Conflict Risk

Niche observability vocabulary (circuit-breaker states, p95/p99 latency, budget guard alerts, model lockouts) makes it mostly distinct from other skills. Not 5 because the target system is unnamed, so generic requests about circuit breakers or latency monitoring in a user's own stack could trigger it incorrectly.

4 / 5

Total

15

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

diegosouzapw/OmniRoute

Path

skills/omni-resilience/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.