Content
67%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 workflow skill: clear phases, concrete templates, explicit gates, and graceful handling of missing sibling skills. Its main weaknesses are redundancy — the use/skip decision is repeated across three sections — and the absence of templates for the user-story and design phases.
Suggestions
Collapse 'Activation Contract', 'When to use this skill', and 'Decision rule' into a single use/skip section; the current layout restates the same triggers three to four times.
Fold 'Common mistakes / gotchas' into the phase where each mistake occurs (e.g., vague tasks belongs in Phase 3) instead of a standalone list.
Add a short user-story format and a design.md skeleton alongside the existing EARS and task templates so all three artifacts are equally executable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | No filler or explanations of concepts Claude already knows, but the when-to-use guidance is stated three times — 'Activation Contract' (use-first/do-not-use/checklist), 'When to use this skill', and 'Decision rule' (use-full/skip-full) — and the 'Minimal checklist' restates it a fourth time. Mostly efficient with a genuine tightening opportunity, hence 3 rather than 4; not 2 because every section is directive and none is padded prose. | 3 / 5 |
Actionability | Concrete, executable guidance throughout: exact file paths ('specs/<spec_name>/requirements.md'), a copy-paste EARS template with a worked example, and a ready-to-use task-format block. Not 5 because Phase 1's user stories and Phase 2's design content get no template or example; not 3 because the guidance is directly usable, not high-level hints. | 4 / 5 |
Workflow Clarity | Four phases are explicitly sequenced with confirmation gates ('Only start implementation after the user confirms the task plan', 'Require confirmation between requirements, design, and task breakdown') plus a minimal checklist. Not 5 because there is no error-recovery feedback loop (e.g., what to do when the user rejects the requirements — revise and re-confirm is only implicit); not 3 because checkpoints are explicit, not missing. | 4 / 5 |
Progressive Disclosure | A single well-sectioned file with no nested references; sibling references ('../ui-design/SKILL.md', '../data-model-creation/SKILL.md') are one level deep, clearly signaled, and carry an explicit fallback when missing (they do not resolve in this environment, though the skill anticipates that). Nothing at this size clearly belongs in a separate file. Not 5 because the skill ships no bundle structure of its own and its cross-references cannot be verified to exist here; not 3 because organization and signaling are solid. | 4 / 5 |
Total | 15 / 20 Passed |