Content
87%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 lean, actionable skill body with concrete commands and a complete output template. The main gap is workflow clarity: a verdict-rendering skill needs explicit decision rules and validation/feedback steps rather than an undefined 'Apply the verdict'.
Suggestions
Add an explicit decision rule mapping the six answers to the verdict (e.g., ship if RICE ranks top-3 AND retention is smiling/flat AND a kill criterion is defined; sharpen if one signal is weak; kill if retention is decaying or no North Star link).
Insert a validation checkpoint after 'Run the analyses' (e.g., confirm each script exited 0 and produced output before proceeding) and a retry path on failure.
Define the SHIP/SHARPEN/KILL thresholds in writing so the verdict is reproducible rather than left to judgment.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean body with short headers, one-liner definitions, and no explanation of JTBD/PMF/RICE concepts Claude already knows; the few aphorisms ('Job ≠ feature', 'The cut list is the focus list') are mnemonic rather than padding. | 5 / 5 |
Actionability | Provides concrete runnable commands (rice_prioritizer.py, pmf_scorer.py, portfolio_analyzer.py) and a fully specified copy-paste output template with placeholders covering all six questions plus a verdict rubric. | 5 / 5 |
Workflow Clarity | A clear three-step sequence exists ('Run the analyses', 'Answer the six questions', 'Apply the verdict'), but there are no validation checkpoints, no feedback loop if a script fails, and no rule mapping the six answers to the SHIP/SHARPEN/KILL verdict — a gap that caps this consequential decision workflow at 3. | 3 / 5 |
Progressive Disclosure | Well-organized into clear sections (When to Run, Six Questions, Workflow, Output Format, Routing, Related) with no nested references; cross-skill pointers are one-level-deep and clearly signaled, and no bundle files are needed. | 5 / 5 |
Total | 18 / 20 Passed |