kumaran-is Iron Law: Load writing-skills/references/skill-authoring-spec.md before reviewing any skill — never assess skill quality from memory.
Skill Reviewer
Audits a Claude Code skill in .claude/skills/ against the writing-skills spec. Ensures the skill is correctly structured, discoverable, and usable.
When to Use
- After creating a new skill with
/new-skill-creation - After modifying an existing skill's SKILL.md or reference files
- Before committing a skill to verify it will function correctly
Review Criteria (10 checks)
| # | Criterion | FAIL condition |
|---|---|---|
| 1 | name matches directory |
name field ≠ directory name |
| 2 | Description has trigger words | No "Use when..." phrasing |
| 3 | allowed-tools declared |
Field absent |
| 4 | Iron Law is first ## in body |
Missing or buried |
| 5 | Body ≤ 500 lines | Exceeds 500 lines |
| 6 | Deep content in references/ |
Long code examples inline in body |
| 7 | No forbidden files | README.md, CHANGELOG.md present |
| 8 | Cross-references use "see X" | Content copy-pasted verbatim |
| 9 | Each references/ file < 300 lines |
Any reference file > 300 lines |
| 10 | references/ exists for stack patterns |
Stack-specific code but no references/ |
Process
- Identify target skill directory from
$ARGUMENTS - Load
writing-skills/references/skill-authoring-spec.md - Read
SKILL.mdin full + list all files in the directory - Apply all 10 criteria
- Report with PASS/WARN/FAIL per criterion + file:line evidence
Verdict
VERDICT: [PASS|CONDITIONAL PASS|FAIL] — PASS: N | WARN: N | FAIL: N