CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

omni-combos-routing

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.

Quality

71%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

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

Quality

Content

57%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 genuinely useful API reference with executable curl examples and a strong strategy table, undermined by substantial duplication between the generated and migrated sections, empty JSON payload placeholders, and no bundled reference file for the schemas it points to. There is no explicit end-to-end workflow with validation steps. Progressive disclosure is weak: everything lives in one ~300-line file and the only schema reference targets a non-bundled path.

Suggestions

Deduplicate: remove the migrated section's repeated list/create/metrics examples (or drop the generated stub sections for them), keeping one authoritative version of each operation.

Add a short end-to-end workflow with checkpoints: create combo → POST /api/routing/simulate to validate → activate via /toggle → call via /v1/chat/completions, verifying each step's response before proceeding.

Replace the dangling `docs/openapi.yaml` pointer with a real bundled reference file (e.g. references/api.md) containing the actual request/response schemas for the endpoints whose bodies are currently `-d '{}'`.

DimensionReasoningScore

Conciseness

Mostly efficient command-based content (the 19-strategy table and curl examples earn their tokens), but the same operations are documented twice — the generated '## Endpoints' section lists `GET /api/combos`, `POST /api/combos`, and `GET /api/combos/metrics` again in the migrated section, and PUT/PATCH repeat identical 'Partial update: the body is merged onto the stored combo' text. The Overview also restates the frontmatter description verbatim, and nearly all generated examples carry empty `-d '{}'` bodies, so it sits between anchors 2 and 3 but not noticeably below the midpoint.

3 / 5

Actionability

Concrete curl commands for every endpoint plus a fully executable create payload ('{"name": "my-combo", "strategy": "priority", "targets": [...]}') and an end-to-end call example (`POST /v1/chat/completions` with `"model": "prod-auto"`). Not a 5 because many endpoints (update, duplicate, reorder, fallback chain create, builder options) ship only `-d '{}'` placeholders, and the real schemas are deferred to `docs/openapi.yaml`, a path that does not exist in this skill's bundle.

4 / 5

Workflow Clarity

The curated section implies a sensible sequence (create → choose strategy → activate → call → metrics → simulate) and the Errors section offers recovery hints ('404 combo not found → check id from /api/combos'), but no explicit workflow ties the operations together and there are no validation checkpoints (e.g., simulate before activating, verify creation before calling). This is a multi-operation API skill, so the simple-skill exception does not apply; the sequence is present but checkpoints are implicit.

3 / 5

Progressive Disclosure

Sections are well-organized with clear headers and references are signaled ('See the full OpenAPI specification at `GET /api/openapi/spec` or `docs/openapi.yaml`', external entry-point SKILL link), but ~200 lines of per-endpoint API reference that belongs in a separate bundled file are inlined, and `docs/openapi.yaml` is a dangling path since no references/ directory exists. This matches anchor 3: structure present, references signaled, but separable content stays inline.

3 / 5

Total

13

/

20

Passed

Description

71%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 strong, specific description in proper third-person verb form that names its domain, its actions, and its strategy catalog without padding. Its one structural weakness is the missing 'when to use' guidance, which caps completeness. Adding trigger phrasing and a few natural synonyms would lift it to the top band.

Suggestions

Append a trigger clause, e.g. 'Use when managing OmniRoute routing combos, configuring fallback chains, or choosing a routing strategy.'

Add natural synonyms users would actually say — e.g. load balancing, failover, model routing — to broaden trigger coverage.

Clarify the product context ('OmniRoute') so 'routing' does not collide with network- or request-routing skills.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'Create and manage routing combos', 'Configure fallback chains, test routing outcomes, and retrieve combo metrics' — and even enumerates named strategies ('priority, weighted, round-robin, Auto-combo'), giving comprehensive coverage of the skill's capabilities. This matches anchor 5 rather than 4, since there are no meaningful gaps in the action list.

5 / 5

Completeness

The 'what' is clearly and specifically answered, but there is no 'Use when...' clause or equivalent trigger guidance anywhere in the description, which caps completeness at 3 per the judging guidelines. It cannot score 4, which requires both what and when with the 'when' present even if imperfect.

3 / 5

Trigger Term Quality

Good keyword coverage: 'routing combos', 'fallback chains', 'strategy', 'metrics', and concrete strategy names users would echo. Not a 5 because natural synonyms and variations users might say — e.g. load balancing, failover, model routing, routing rules — are absent.

4 / 5

Distinctiveness Conflict Risk

Terms like 'routing combos', 'Auto-combo', and 'fallback chains' carve out a distinct niche with minimal overlap, though generic words like 'routing' and 'metrics' leave minor conflict risk with general traffic- or request-routing skills. This sits between anchors 4 and 5; the absence of explicit trigger phrases keeps it from clearly matching anchor 5's minimal-conflict example.

4 / 5

Total

16

/

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-combos-routing/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.