Content
63%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-structured, genuinely actionable instruction skill whose main flaw is duplication: the entire SKILL.md template is inlined in the body even though it exists as a bundle file in assets/. Removing that duplication would simultaneously improve conciseness and progressive disclosure.
Suggestions
Replace the inlined SKILL.md Template section (lines 44-78) with a short pointer to assets/SKILL-TEMPLATE.md, since the asset already contains a fuller version.
Add an explicit numbered creation workflow with commands (e.g. mkdir -p skills/{skill-name}, write SKILL.md, register in AGENTS.md) ending in a verification step.
Provide at least one real copy-paste command instead of placeholder-only Commands guidance ({Common commands}).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient — tables, decision trees, and a checklist with no explanations of concepts Claude already knows — but the full SKILL.md template (lines 44-78) is inlined while a near-identical copy exists in assets/SKILL-TEMPLATE.md, a clear tightening opportunity. This fits "mostly efficient but could be tightened" rather than the minor-trim level of 4. | 3 / 5 |
Actionability | Concrete guidance throughout: a naming-conventions table, a frontmatter fields table, copy-paste registration snippet for AGENTS.md, and an explicit decision tree for assets/ vs references/. It falls short of 5 because the skill gives no actual creation commands (e.g. mkdir/scaffold commands) and its own Commands guidance is placeholder-only ({Common commands}). | 4 / 5 |
Workflow Clarity | Sections are logically sequenced (when to create → structure → template → naming → decisions → registration) and the closing "Checklist Before Creating" plus the registration step act as validation checkpoints. Sequence is implied by ordering rather than explicitly enumerated, and no run-validation step exists, so it fits anchor 4 rather than 5; the skill is non-destructive so the workflow cap of 3 does not apply. | 4 / 5 |
Progressive Disclosure | The assets/ link at the end is a real, one-level-deep bundle file (assets/SKILL-TEMPLATE.md exists), but the body inlines the full template that already lives in that separate file — content that should be separate is inline. This matches anchor 3 ("content that should be separate is inline") despite otherwise good structure and signaling. | 3 / 5 |
Total | 14 / 20 Passed |