Content
82%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-architected meta-skill body that models the progressive-disclosure pattern it teaches: lean, opinionated, and structured around three clear modes with sequenced steps and validation. The main weakness is two Resource pointers (template files) that reference non-existent bundle files.
Suggestions
Add the missing templates/SKILL.template.md and templates/reference.template.md files referenced in the Resources section, or remove those entries so every pointer resolves to a real bundle file.
Inline at least one concrete validation checkpoint (e.g. the trigger-test command) in each mode's quick spine rather than deferring all of it to references/validation.md.
For the refactor mode, surface an explicit destructive-change checkpoint inline given that extraction/trimming alters the original skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is a lean, opinionated spine that assumes Claude's competence and pushes detail to references; no padding or restating of concepts Claude already knows, and every line earns its place. | 5 / 5 |
Actionability | Each mode has concrete numbered steps with specific actions (e.g. "copy templates/SKILL.template.md into .claude/skills/<name>/SKILL.md") and pointers, but the body intentionally defers most executable detail to references, leaving minor gaps for an instruction-only skill. | 4 / 5 |
Workflow Clarity | Multi-step processes for create/refactor/consolidate are clearly sequenced with validation checkpoints referenced ("Validate & iterate (references/validation.md)" and the behavior-preservation check), but the validation detail itself is deferred rather than an inline checkpoint, a minor gap. | 4 / 5 |
Progressive Disclosure | Clear overview with well-signaled one-level-deep references to references/*.md, and content is appropriately split; however the body also points to templates/SKILL.template.md and templates/reference.template.md in Resources, but no templates/ directory exists in the bundle, so two referenced paths are dangling. | 4 / 5 |
Total | 17 / 20 Passed |