CtrlK
BlogDocsLog inGet started
Tessl Logo

add-command

Use this skill when the user asks to "add a command", "implement cx <something>", "new subcommand", "new CLI command", "add a new cx command", "create a command", "add subcommand", "implement a new command", "build a cx command", "wire up a new command", "extend the CLI", "add an API to cx", "new cx feature", "integrate a Coralogix API", or wants to add new functionality to the cx CLI. Use this even when the user describes a feature that implies a new command without saying "command" explicitly.

67

3.61x
Quality

78%

Does it follow best practices?

Impact

94%

3.61x

1 of 3 eval scenarios. Add 2 more for a full score.

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.claude/skills/add-command/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

81%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 strong operational workflow: codebase-specific patterns are captured with reasons, steps are sequenced with a decision gate and a real verify-fix loop, and detail is consistently delegated to a single well-signaled doc. The main gaps are minor redundancy between the archetype overview and Step 1, and templates living entirely in an external doc.

DimensionReasoningScore

Conciseness

The body is dense with codebase-specific knowledge Claude cannot know (wrapper groups, render helpers, serde conventions, e2e discover_* pattern) and explains only the 'why' behind non-obvious rules ("stdout is reserved for data so piped output isn't polluted"). Not 5 because of minor redundancy — e.g., the archetype table's reading list overlaps Step 1's per-archetype reading list, and conventions summarized in Steps 2-4 partially duplicate what is deferred to docs/adding-a-command.md.

4 / 5

Actionability

Highly concrete: exact file paths (src/commands/alerts/api.rs), function signatures (render_<domain>_text(merged: &MergedResults) -> Result<()>), serde attributes, and runnable commands (cargo test --test e2e -- --ignored --test-threads=1, cx schema). Not 5 because the copy-paste code templates live in docs/adding-a-command.md rather than this body, so a few steps (e.g., the fan-out loop) remain prose rather than executable code.

4 / 5

Workflow Clarity

A clearly sequenced 7-step workflow with a decision gate up front (Step 0 archetype table), per-archetype branching, and an explicit validation step (Step 7: cargo build/test/clippy/fmt with 'Fix any issues before committing') plus e2e and smoke-testing of all three output formats and multi-profile behavior — a full feedback loop with checklists referenced via the PR Checklist section.

5 / 5

Progressive Disclosure

The body is well-sectioned and consistently defers templates to a single, clearly signaled, one-level-deep reference (docs/adding-a-command.md, cited with section pointers like § "CLI Wiring" and § "Testing"). Not 5 because no bundle reference files actually ship with the skill, and a moderate amount of convention detail inlined in Steps 2-4 duplicates what the referenced doc covers — it could be pushed down to shorten the overview.

4 / 5

Total

17

/

20

Passed

Description

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

An exceptional trigger list that maximizes recall and even covers implicit-intent requests, but it is entirely 'when' with no explicit 'what' — the description never states what the skill does once invoked. Adding a one-sentence capability summary up front would make it a model description.

Suggestions

Open with a concise 'what' clause before the trigger list, e.g., 'End-to-end workflow for implementing a new subcommand in the cx CLI: archetype selection, REST API layer, wiring, tests, and a user-facing skill.'

State the skill's concrete outputs/capabilities (API layer creation, CLI wiring, three-layer test suite, smoke-testing all output formats) so the 'what' is explicit rather than inferred from triggers.

Disambiguate the generic triggers ("add a command", "create a command") by binding them to cx, e.g., "add a command (to cx)", to eliminate overlap risk with other CLI projects.

DimensionReasoningScore

Specificity

The description names the domain precisely ("the cx CLI", "a Coralogix API", subcommands) and the core action (adding a command), but never states what the skill actually does when invoked (e.g., an end-to-end workflow covering archetype selection, API layer, wiring, tests). It sits at the 'names domain and 1-2 concrete actions, but not comprehensive' anchor — not 4 because no list of several concrete capabilities is given, not 2 because the domain and action are concrete rather than generic.

3 / 5

Completeness

The 'when' is answered explicitly and thoroughly ("Use this skill when the user asks to..."), but the 'what' is never explicitly stated — the reader must infer from the triggers that the skill implements a new cx command. This matches 'what' present but only implied; not 2 because the what is strongly and consistently implied by every trigger phrase rather than absent or vague.

3 / 5

Trigger Term Quality

Fourteen quoted natural phrases ("add a command", "new subcommand", "build a cx command", "wire up a new command", "extend the CLI", "integrate a Coralogix API") plus a catch-all ("add new functionality to the cx CLI") and an implicit-intent clause give comprehensive synonym coverage of how users would actually phrase this request.

5 / 5

Distinctiveness Conflict Risk

Anchoring on cx, Coralogix, and CLI subcommands carves a clear niche with minimal conflict risk. Not 5 because a few generic triggers ("add a command", "create a command", "new CLI command") could plausibly fire for other CLI projects the user is working on.

4 / 5

Total

15

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

13

/

16

Passed

Repository
coralogix/cx-cli
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.