CtrlK
BlogDocsLog inGet started
Tessl Logo

dx

Developer Experience (DX) review and advisory skill for CLI tools, shell scripts, developer tooling, and automation. Analyzes code against established CLI design guidelines (clig.dev, Heroku CLI Style Guide, 12 Factor CLI), composability principles, error handling best practices, and developer ergonomics. Triggers on: "dx review", "review dx", "check cli", "improve the cli", "dx audit", "review this tool", "is this usable", "check ergonomics", "dx feedback", "review the script", "improve usability", "check error handling", "review output", "dx writing", "improve help text", "review flags", "make this more intuitive", "dx best practices", "/dx".

61

Quality

77%

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/quality/dx/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

60%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 presents a clear, well-sequenced review workflow with concrete finding specs and severity criteria, and it correctly delegates detailed rules to one-level-deep reference files. However, the entire referenced bundle (11 rules/*.md files and templates/review-report.md) is missing, so the skill's core analysis content and report format are unreachable as shipped, and roughly a third of the body restates CLI basics Claude already knows.

Suggestions

Ship the referenced bundle files: all 11 rules/*.md files and templates/review-report.md are cited in the body but absent from the bundle, leaving Phases 2 and 3 unexecutable — either include them or inline the essential rules into SKILL.md.

Trim the 'Key Principles (Quick Reference)' section: standard flags (-h/--help, --version), exit codes (0/1/2/126/127/130), and the stdout/stderr split are knowledge Claude already has — keep only the skill-specific judgments (severity criteria, safety hierarchy, response-time policy for when to flag a violation) and move the rest into a rules file.

Include one worked example finding (cited line, named principle, severity, and a code fix) directly in the body so the expected output shape is reproducible even when the report template file is unavailable.

DimensionReasoningScore

Conciseness

The workflow sections are tight, but the 'Key Principles (Quick Reference)' section (~30 of ~107 lines) restates concepts Claude already knows: '### Standard Flags (Always Support) - -h, --help: Show help text', '### Exit Codes - 0: Success ... 127: Command not found', and '### Output Streams - stdout: Primary output ... stderr: Logs, errors'. This is mostly efficient with a meaningful block of unnecessary known material — matching anchor 3 rather than anchor 4, where over-explanation would be only minor.

3 / 5

Actionability

As an instruction-only advisory skill the guidance is concrete: a decision table mapping code features to rule files ('Help text, usage strings, --help | rules/help-and-documentation.md'), a four-part finding spec ('Identify the specific line(s) ... Name the violated principle ... Explain why ... Provide a concrete fix with code'), a worked specificity example ('"--output flag on line 42 shadows POSIX -o convention" not "flags should follow conventions"'), and severity criteria. It falls short of anchor 5 because no example finding or inline output format is shown — the report format lives entirely in a template file that is not present in the bundle.

4 / 5

Workflow Clarity

A clear three-phase sequence ('Phase 1: Context Discovery' → 'Phase 2: Analysis' → 'Phase 3: Report') with numbered steps, a tool-type taxonomy, and checkpoints ('If ambiguous, ask the user', 'Read all target files completely. Do not review code you haven't read'). This is an advisory skill with no destructive or batch operations, so the validation cap does not apply; it sits at anchor 4 rather than 5 only because there is no step validating the produced report (e.g., confirming findings are grounded in cited lines) before output.

4 / 5

Progressive Disclosure

The body is architected correctly for progressive disclosure — an overview delegating detail to well-signaled, one-level-deep references ('rules/core-principles.md', 'rules/error-handling.md', 'templates/review-report.md', selected via a clear table) — but the actual bundle contains no rules/ or templates/ directories: all 12 referenced paths are dangling. Scored against the actual bundle structure as the guidelines direct, the disclosure structure is broken as shipped: the detailed content is neither inlined nor reachable, which is a structural failure below anchor 3 (references present and functional but imperfectly organized).

2 / 5

Total

13

/

20

Passed

Description

86%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 description: it clearly states what the skill does, grounds it in named CLI design authorities, and provides an explicit, comprehensive trigger list in third-person voice. The main weakness is that the capability description centers on a single analyze/review action rather than enumerating several distinct concrete actions, and a few generic trigger phrases ('review this tool', 'review the script') could collide with general code-review skills.

DimensionReasoningScore

Specificity

The description names the domain ('Developer Experience (DX) review and advisory skill for CLI tools, shell scripts, developer tooling, and automation') and one concrete action ('Analyzes code against established CLI design guidelines (clig.dev, Heroku CLI Style Guide, 12 Factor CLI), composability principles, error handling best practices'), but the actions boil down to review/advise/analyze rather than a list of several distinct capabilities. This matches anchor 3 (domain plus 1-2 concrete actions, not comprehensive); it is above anchor 2 because the named frameworks make the action concrete, and below anchor 4 because no additional specific actions (e.g., producing severity-classified reports or code fixes) are stated.

3 / 5

Completeness

Both questions are explicitly answered: the 'what' ('Developer Experience (DX) review and advisory skill... Analyzes code against established CLI design guidelines... composability principles, error handling best practices, and developer ergonomics') and the 'when' via an explicit trigger clause ('Triggers on: "dx review", "review dx", ...') with concrete trigger phrases — equivalent to a 'Use when...' clause, so the completeness cap of 3 for missing trigger guidance does not apply. Voice is third person ('Analyzes'), so no person-voice penalty.

5 / 5

Trigger Term Quality

Nineteen explicit triggers give comprehensive natural-term coverage with synonyms: 'dx review', 'review dx', 'check cli', 'improve the cli', 'dx audit', 'review this tool', 'is this usable', 'check ergonomics', 'improve usability', 'check error handling', 'improve help text', 'review flags', 'make this more intuitive', '/dx'. These are phrases a user would naturally say when needing this skill, matching the anchor-5 example's synonym density (file extensions are not meaningful for this domain).

5 / 5

Distinctiveness Conflict Risk

The DX/CLI niche and dx-specific triggers ('dx review', 'dx audit', 'dx feedback', '/dx') are clearly distinct, but several generic trigger phrases — 'review this tool', 'review the script', 'review output', 'check error handling' — would plausibly also match a general code-review or security-review skill, creating minor overlap risk with closely related skills. This fits anchor 4 (mostly distinct, minor overlap) rather than anchor 5 (minimal conflict risk) because of those generic phrases, and is clearly above anchor 3 since the core triggers are unmistakably DX-specific.

4 / 5

Total

17

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_field

'metadata' should map string keys to string values

Warning

Total

15

/

16

Passed

Repository
mthines/agent-skills
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.