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 well-constructed instruction-only skill body: a fully executable diagnostic procedure with concrete numbers and decision rules, compact tables instead of prose, and exemplary progressive disclosure via a when-to-read reference table pointing to a real, one-level-deep bundle. The only trimmable fat is the philosophical/routing material that duplicates the frontmatter, and the workflow lacks an explicit failure-recovery loop.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with actionable specifics (the lever table, "plan on 10–40% relative lift", "+20% then +30% = 1.20 × 1.30 = 1.56", "~2× the rate of full-price customers") and explains nothing Claude already knows, but the Core Philosophy section and the When-this-matters/When-pricing lists restate routing already in the description and could be trimmed. | 4 / 5 |
Actionability | The Diagnostic Loop is fully prescriptive ("score each of the four levers 1–10. The lowest is the binding constraint", "Pick one lever to fix this iteration", "Multiply the lifts, don't add them"), the lever table gives concrete moves per lever, and the Banned Vocabulary section pairs each banned pattern with a replacement rule ("Use specific numbers, named customers, concrete outcomes, real timelines"). | 5 / 5 |
Workflow Clarity | The 7-step numbered Diagnostic Loop has a clear sequence with embedded diagnostic checkpoints (score levers, audit anatomy) and a final validation step ("Confirm the combined offer with a test"), but there is no explicit error-recovery or iterate-on-failure feedback loop, which keeps it below the top anchor. | 4 / 5 |
Progressive Disclosure | The body is a genuine overview: each framework section ends with a well-signaled pointer ("For the full framework... see references/value-equation.md"), and a Reference Library table lists all 8 reference files with per-file "When to read" guidance; all 8 files exist in references/ and contain no further nesting, so references are exactly one level deep. | 5 / 5 |
Total | 18 / 20 Passed |