Content
75%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.
The content is a well-structured, actionable instruction skill: a clear three-step process with a user-checkpoint, plus a complete inline spec template with a worked example. It scores solidly across all dimensions with only minor gaps — no publish mechanism detail and slight wordiness in places.
Suggestions
Specify how to publish to the issue tracker (or explicitly defer to the vocabulary provided by /setup-matt-pocock-skills) so the final step is fully executable.
Illustrate "seam" guidance with a one-line concrete example (e.g. HTTP endpoint vs. internal function) so "highest seam" is unambiguous.
Tighten the opening paragraph (which repeats the description) and redundant phrasings like "A LONG, numbered list" / "extremely extensive".
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean — every template line instructs rather than explains concepts Claude already knows. Not a 5 because the opening paragraph re-states the description and a few lines ("This list of user stories should be extremely extensive and cover all aspects of the feature") could be tightened; no real padding keeps it above 3. | 4 / 5 |
Actionability | For an instruction-only skill, the guidance is largely executable: a three-step process, a complete spec template, a worked user-story example, and the concrete `ready-for-agent` label. Not a 5 because the publish mechanism is assumed externally and "Use the highest seam possible" relies on inferred vocabulary without a concrete illustration. | 4 / 5 |
Workflow Clarity | The sequence (explore → sketch seams → write spec → publish) is clear with an explicit checkpoint ("Check with the user that these seams match their expectations") and a conditional recovery path ("run /setup-matt-pocock-skills if not"). Not a 5 because writing and publishing share one step with no verification before the outward-facing publish; not capped at 3 since no destructive or batch operation is involved. | 4 / 5 |
Progressive Disclosure | No bundle files exist, and the body is well organized into intro, Process, and a template that legitimately belongs inline since it is used on every invocation. Not a 5 because at ~70 body lines it exceeds the simple-skill heuristic (under 50 lines) and the template could optionally live in a referenced file to keep SKILL.md leaner. | 4 / 5 |
Total | 16 / 20 Passed |