Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a strong planning skill with excellent structure, clear workflows, and highly actionable guidance. The four-move framework (Scope, Decompose, Sequence, Pre-mortem) provides a clean mental model with concrete steps and validation checkpoints. The main weakness is moderate verbosity — some sections (particularly Story mapping from discovery and the stance description) could be tightened to save tokens without losing clarity.
Suggestions
Tighten the 'Your Stance' section — the two-lens concept could be conveyed in 2 sentences instead of a full paragraph.
The 'Story mapping from discovery' pattern is the longest section and could be condensed by ~30%, e.g., combining steps 1-2 and trimming explanatory asides like 'This is the spine of the mapping.'
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is mostly efficient and avoids explaining concepts Claude already knows, but some sections are verbose — e.g., the 'Your Stance' section's philosophical framing and the 'Story mapping from discovery' pattern is quite lengthy. Several bullet points could be tightened without losing meaning. | 2 / 3 |
Actionability | The skill provides highly concrete, specific guidance: exact file paths (docs/discovery/ideas/<slug>.md), explicit artifact schemas to consult, named fields to set (from_discovery), clear processes with numbered steps, and specific anti-patterns. While there's no executable code, this is an instruction-only planning skill where the guidance is fully actionable. | 3 / 3 |
Workflow Clarity | The four moves are clearly sequenced with explicit inputs, outputs, and validation checkpoints (e.g., 'M1 without a demo-able outcome isn't a milestone,' 'when discovery is incomplete, story mapping isn't ready'). The story mapping and spec→tasks processes have clear numbered steps with decision points and feedback loops. Failure modes section serves as a validation checklist. | 3 / 3 |
Progressive Disclosure | Excellent structure: the main file provides a clear overview of four moves with enough detail to act, then points to one-level-deep references (references/scope.md, references/decompose.md, etc.) and per-type artifact guides (project.md, epic.md, etc.). Navigation is well-signaled with a dedicated 'Detailed Guidance' section and inline links throughout. | 3 / 3 |
Total | 11 / 12 Passed |