SKILL.md:1the skill works → no evals/, tests/, or verification section found
No way to prove the skill does what it claims.
Fix Add an evals/ folder (test prompts + expected outcomes) and a '## Verify' step in the body.
overall
Correctness & Structure
100
pass
Triggering & Discoverability
85
1 warn
Clarity & Instructions
75
1 warn
Token & Context Cost
91
1 warn
Safety & Security
100
pass
Verifiability & Maintainability
53
1 fail
Top fixes — ranked by score impact
SKILL.md:1description will match user requests → no explicit cue ('use when …', 'triggers on …', quoted user phrases) found
Pure what-it-does prose — the model has to guess when to invoke it.
Analyze code coverage and CRAP (Change Risk Anti-Patterns) scores to identify…
Fix State the trigger explicitly: 'Use when the user says "…", "…", or wants to …'.
SKILL.mdeverything inlined in SKILL.md → 384 body lines, 0 supporting files
Large SKILL.md (384 lines) with no supporting files — all of it loads every time the skill fires.
Fix Move heavy reference material into supporting files and link to them, so the model loads it only when needed.
SKILL.md:191
Decorative ASCII-art / banner line — pure token cost, no instructional value.
─────────────
SKILL.md:193
Decorative ASCII-art / banner line — pure token cost, no instructional value.
──────────────────────────────────────────────────────────────────
Fix Delete decorative banners and persona filler; keep instructions plain and imperative.
★ scores higher than ≈16% of 208 public skills (deterministic rubric v1.2 sample, 2026-09)
Embed this badge
Always-fresh — it re-scans and updates on its own.
Grade your own Claude Code skill — evidence-cited, file-and-line, free.
Scan your own skill →