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-crafted instruction skill: a lean, jargon-assuming 7-step workflow with concrete decision menus and per-step template references, backed by a real one-level-deep bundle that all checks out. The only meaningful gap is the absence of an explicit validation checkpoint confirming timebox/success criteria before classifying the spike outcome.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and bullet-driven: it assumes competence (never explains what Shape Up, a breadboard, or a fit check is), keeps every section to decision-relevant guidance, and its only prose ("Spikes are not mini-projects. They exist to remove a tail of risk.") is load-bearing framing rather than padding. Every token earns its place, matching the top anchor; it is not a 4 because there is no over-explanation left to trim. | 5 / 5 |
Actionability | For an instruction-only skill the guidance is highly concrete: a 7-step workflow, four named mitigation moves (patch/out-of-bounds/cut/spike), a five-field spike specification, three outcome classifications with follow-on decisions, and per-step pointers to specific templates. It falls short of fully executable (5) because step 4 "Execute the spike" and the wiring/integration/performance/state spike shapes remain necessarily abstract with no concrete worked steps or example embedded inline. | 4 / 5 |
Workflow Clarity | Steps 1-7 are clearly numbered and sequenced, step 5 embeds an explicit decision branch (proceed/revise/drop) that acts as a checkpoint, and the Quality bar section is a checklist ("Timebox honoured", "Spike reduces risk *or* triggers a scope cut"). It sits below 5 because there is no explicit verify/re-validate loop — e.g. no step confirming the timebox or success criteria were actually met before classification — leaving minor validation gaps per the anchor. | 4 / 5 |
Progressive Disclosure | SKILL.md is a clear overview-only workflow; all detail is delegated one level deep to real, existing files — templates/risk-register-template.md, spike-plan-template.md, spike-report-template.md (all verified present with substantive content), shapeup-risks-rabbit-holes-notes.md, and examples/sample-spike.md — each referenced inline at the step where it is needed and summarized in the Bundled resources section. Content is appropriately split with easy navigation, matching the top anchor exactly. | 5 / 5 |
Total | 18 / 20 Passed |