Content
86%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 high-quality instruction skill: the play-selection table, ranked-assumption workflow, concrete deliverable template, and 'where the experts disagree' section make it immediately actionable, and bundle files are well-structured with clear one-level-deep navigation. The only weaknesses are mild redundancy with references/quotes.md in the Receipts section and inconsistent 'Done when' exit criteria across the test subsections.
Suggestions
Trim the 'Receipts' section to one or two anchor quotes (or drop it entirely) since all six quotes are already duplicated in references/quotes.md, which the 'Go deeper' section links.
Add a short 'Done when:' exit criterion to each of 3C, 3D, and 3E, matching the one 3B already has, so every test type has an explicit completion checkpoint.
Consider moving the full 'Where the experts disagree' camp detail into references/frameworks.md and keeping only the defaults inline to reduce body tokens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes Claude's competence throughout — it never explains what an MVP or design sprint is, only operational specifics like 'about 20 people you don't know' and 'roughly 10 to get 1 call'. Minor redundancy keeps it below a 5: the six 'Receipts' quotes are duplicated verbatim in references/quotes.md, which the body already links. | 4 / 5 |
Actionability | Fully executable for an instruction-only skill: a copy-paste-ready deliverable template in a fenced markdown block, exact interview questions ('Walk me through the last time this happened. What did you do about it?'), a filled-in pass/kill line example, and a 1/3/5-anchored grading rubric covering common cases (grading a PRD, deciding between plays). | 5 / 5 |
Workflow Clarity | Clear Diagnose → Pick the play → Run (3A–3F) → Readout sequence with pre-committed pass/kill lines, a per-interview scorecard, and an explicit feedback loop ('decide go/pivot/kill, edit the hypothesis, and run the next one-week round'). Falls short of 5 only because exit criteria are inconsistent — just 3B has a 'Done when:' checkpoint while other subsections lack them. | 4 / 5 |
Progressive Disclosure | The body holds the operational playbook while deeper material is correctly split into references/frameworks.md and references/quotes.md — both real files, one level deep, each clearly signaled under 'Go deeper' with a one-line description of its contents, plus related-skill navigation. | 5 / 5 |
Total | 18 / 20 Passed |