CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cli-models

Query available AI models, list model aliases, and browse the full model catalog from the CLI. Filter by provider, search by capability, and resolve model name variants.

Quality

74%

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/cli-models/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

68%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 well-organized, lean CLI command reference with concrete flags and mostly executable syntax. Its main weaknesses are templated placeholder examples rather than concrete invocations, implicit rather than explicit validation steps (notably for the destructive remove operation), and a redundant Overview section that duplicates the frontmatter description.

Suggestions

Replace placeholder examples with concrete executable invocations using realistic values (e.g., `omniroute models openai --search sonnet`, `omniroute models add openai gpt-4o --name "GPT-4o" --dry-run`).

Add explicit validation checkpoints for mutating/destructive operations — e.g., recommend running `--dry-run` first for `models remove` and describing what to check before confirming with `--yes`.

Trim the Overview that duplicates the frontmatter description verbatim, and group related subcommands (query/browse vs. manage) to improve navigation.

DimensionReasoningScore

Conciseness

The body is lean — flag lists and command examples with no padding or explanations of concepts Claude already knows — matching the 'efficient; minor instances that could be trimmed' anchor. It is not 5 because the Overview repeats the frontmatter description verbatim and the generator comment adds no value.

4 / 5

Actionability

Real subcommands and concrete flag documentation provide mostly executable guidance with concrete syntax. It falls short of 5 because most examples are literal templates (e.g., "omniroute models [provider]", "omniroute models add <provider> <model-id>") rather than copy-paste-ready invocations with real values; only the test-add example uses concrete arguments.

4 / 5

Workflow Clarity

Per-subcommand one-line descriptions mention sequencing and verification ("then add it after a synthetic tool round-trip", "then verify persistence"), but validation checkpoints are only implicit — there is no guidance on how to verify or what to do on failure. The destructive `models remove` operation lists --dry-run and --yes flags with no validation workflow, which caps workflow clarity at 3 per the judging guidelines.

3 / 5

Progressive Disclosure

The body is well structured with a Quick install section and clear ### headers per subcommand, and at ~113 lines keeping the reference inline is defensible with no external bundle files needed. It is not 5 because the subcommands are not grouped (e.g., read/query vs. manage operations) to aid navigation, and the >50-line simple-skill exception does not apply.

4 / 5

Total

15

/

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 solid third-person description with multiple concrete, specific capabilities and good natural keywords, but it is incomplete: there is no explicit "when to use" trigger guidance, and it omits the model management operations (add/edit/remove) that make up half the skill's subcommands.

Suggestions

Add an explicit trigger clause, e.g., "Use when the user asks which models are available, wants to look up or resolve a model name, or needs to browse the model catalog from the CLI."

Include the model management capabilities (add, edit, remove manual models) so the description covers what the skill body actually offers.

Add natural synonyms such as "LLM", "available models", or "model list" to broaden trigger term coverage.

DimensionReasoningScore

Specificity

The description lists several concrete actions ("Query available AI models, list model aliases, and browse the full model catalog from the CLI. Filter by provider, search by capability, and resolve model name variants"), matching the 'lists several specific actions; minor gaps' anchor. It falls short of 5 because the skill body also covers model management operations (add, edit, remove, test-add) that the description omits entirely.

4 / 5

Completeness

The "what" is clearly answered with concrete capabilities, but there is no "Use when..." clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. This fits the anchor 'Has a clear what but when is missing or only weakly implied' exactly.

3 / 5

Trigger Term Quality

Natural keywords like "AI models", "model aliases", "model catalog", "provider", and "CLI" give good coverage of what a user would say when needing this skill. It is not a 5 because common synonyms and variations (e.g., "LLM", "available models", "model list") are missing, and "resolve model name variants" is somewhat technical phrasing.

4 / 5

Distinctiveness Conflict Risk

The CLI-focused model catalog/query niche ("from the CLI", "model aliases", "filter by provider") is mostly distinct with only minor overlap risk against general model-selection or LLM-reference skills. It is not 5 because "AI models" is a broad term that could collide with other model-related skills lacking a tool-specific qualifier.

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/cli-models/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.