Content
85%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a well-structured, highly actionable multi-phase skill with excellent workflow sequencing, validation gates, and one-level-deep progressive disclosure. The only weakness is mild verbosity from motivational framing that could be trimmed without losing clarity.
Suggestions
Trim reflective/motivational prose (e.g. 'Research tells you what the market looks like from the outside...', 'The quality of everything downstream depends on how much context you extract now') to reduce tokens without losing guidance.
Shorten the extended framing around the Research Gate and synthesis sections to imperative instructions; the reasoning guidance can be condensed to a few bullets.
Consider moving the long reference-files table to a single concise list or merging it with the inline '> Reference:' callouts to avoid restating when-to-read information twice.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and actionable, but padded with motivational framing Claude doesn't need — e.g. 'Research tells you what the market looks like from the outside. Customer interviews tell you what the problem feels like from the inside', 'The quality of everything downstream depends on how much context you extract now', and extended reflective prose around synthesis and the research gate. It is tighter than anchor 1's concept-explaining verbosity but not the lean every-token-earns-its-place of anchor 3. | 2 / 3 |
Actionability | Provides concrete file paths, per-phase output specs, exact search templates ('"{problem domain} software"', 'site:producthunt.com'), explicit matrix columns, and copy-paste-ready gate criteria (4+ of 5 interviewees, ±30% sensitivity, Stage A/B labels). Matches anchor 3's fully executable, specific guidance. | 3 / 3 |
Workflow Clarity | Clear sequenced 8-phase flow with explicit validation checkpoints and feedback loops: Phase 3.5a verification with critical-vs-warning branching, Research Gate go/no-go, Interview Gate proceed/reassess criteria, PROGRESS.md checkpointing, and resume logic. Matches anchor 3's clear sequence with explicit validation and error-recovery loops. | 3 / 3 |
Progressive Disclosure | Body is an overview pointing to 15 reference files confirmed to exist; references are one level deep, each clearly signaled with '> **Reference:** Read ...' callouts and a navigation table (File / When to Read / ~Lines / Purpose). Heavy agent templates and specs are appropriately split out, matching anchor 3. | 3 / 3 |
Total | 11 / 12 Passed |