CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cli-setup

Run initial setup, configure global CLI settings, manage environment variables, check for updates, and configure autostart via the CLI setup and config commands.

Quality

66%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

High

Do not use without reviewing

Fix and improve this skill with Tessl

tessl review fix ./skills/cli-setup/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

43%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.

The body functions as a scannable command reference with real command names, but it reads like unedited generator output: duplicated subcommand sections, placeholder-only examples, a truncated sentence, and no workflow or validation guidance. It tells Claude what commands exist but not how to sequence them or how to recover from mistakes.

Suggestions

Deduplicate the repeated `config get`, `config set`, and `config list` sections and fix the truncated "Generate OpenCode config (alias for" sentence.

Replace placeholder-only examples with at least one worked example per non-trivial command (e.g., `omniroute config set claude --model sonnet --yes`) and briefly state what each flag does.

Add a short workflow section: run `setup` first, use `config validate <tool>` before `config set`, and `update --check` / `--dry-run` before `--apply`, with what to do when validation fails.

DimensionReasoningScore

Conciseness

The body has no padded prose, but it wastes tokens on duplication and empty examples: `config get`, `config set`, and `config list` each appear twice, and most "Example" blocks (e.g., the five `autostart` variants) merely restate the heading verbatim, adding no information. This is noticeably below the lean every-token-earns-its-place anchor and sits in the could-be-tightened range.

3 / 5

Actionability

Real commands are given, but the examples are the bare command with unsubstituted placeholders (e.g., `omniroute config set <tool>` with `--model <model>` and no worked example), and "Generate OpenCode config (alias for" is a truncated, incomplete sentence. Concrete guidance exists but is incomplete with missing key details, rather than mostly-executable with only minor gaps.

3 / 5

Workflow Clarity

There is no sequencing guidance for the inherently multi-step flows (initial `setup` before `config set`, `config validate` before writing), no validation checkpoints despite `config validate` and `update --dry-run` existing as commands, and destructive/batch-style config writes lack any feedback loop. Structure exists (commands grouped by subcommand) so it is above the incoherent anchor at 1, but steps and checkpoints are largely absent.

2 / 5

Progressive Disclosure

The section structure (## Subcommands with ### per command) is clear, but the ~270-line flat reference has no external files to offload detail, repeats three subcommand sections, and buries unexplained flags in lists. This matches the some-structure-but-could-be-better-organized anchor rather than the well-signaled one-level-deep-references anchor at 4.

3 / 5

Total

11

/

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.

The description is specific and comprehensive about what the skill does, covering all five functional areas of the CLI. Its main weakness is the absence of any explicit "when to use" trigger guidance, which caps completeness. Adding a "Use when..." clause with natural trigger phrases would make it a strong top-tier description.

Suggestions

Append a trigger clause such as "Use when the user asks to set up omniroute, change CLI configuration or settings, manage environment variables, enable autostart, or check for/install updates."

Include a few natural synonyms users might say (e.g., "install", "initialize", "env vars") to broaden trigger-term coverage.

DimensionReasoningScore

Specificity

"Run initial setup, configure global CLI settings, manage environment variables, check for updates, and configure autostart" lists five distinct concrete actions that comprehensively cover the CLI's setup/config surface, matching the comprehensive-coverage anchor rather than the minor-gaps anchor at 4.

5 / 5

Completeness

The "what" is clear (the five enumerated actions), but there is no "Use when..." clause or equivalent explicit trigger guidance, which caps completeness at 3 per the judging guidelines. It is not a 4 because the "when" is entirely absent rather than merely under-specified.

3 / 5

Trigger Term Quality

Good keyword coverage — "setup", "configure", "environment variables", "check for updates", "autostart", "CLI" are phrases a user would naturally say — but common synonyms like "install", "initialize", "settings", or "env vars" are missing, so it falls short of the comprehensive synonyms-and-extensions anchor at 5.

4 / 5

Distinctiveness Conflict Risk

"via the CLI setup and config commands" grounds the description in a specific tool's command surface (autostart, config, env, setup, update), making it mostly distinct; it is not a 5 because generic phrases like "run initial setup" and "configure global CLI settings" carry minor overlap risk with other setup/config-oriented skills.

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