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 tight, well-organized instruction-only principle skill: lean prose, concrete decision rules (triviality bar, deterministic lever beats fan-out, commit when work outlives the session), and an explicit prove-it-by-rerun validation step. The only real gap is that the core workflow and the delegate-skill contract are described in prose bullets rather than as an explicit ordered sequence or shown artifact.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and every line carries instruction — "Do the first unit by hand to learn the recipe, then build the tool. Prove it by rerunning it on that unit and diffing against your hand-done version" — with no padding and no explanation of concepts Claude already knows. It matches anchor 5: every token earns its place. | 5 / 5 |
Actionability | Concrete, executable guidance throughout: a prove-it loop (rerun and diff against the hand-done unit), a task-to-tool mapping ("Codemod or script for edits, generator for repetitive files, a dump-to-sqlite query for analysis, a rerunnable check for verification"), and a triviality escape hatch. It is below anchor 5 only because some guidance stays at the heuristic level (e.g., the delegate skill's 'verification contract' and 'do-not-touch fences' are named but not shown). | 4 / 5 |
Workflow Clarity | A clear sequence is present — do the first unit by hand, build the lever, prove it by rerunning and diffing, apply, commit when the work outlives the session — and it includes an explicit validation checkpoint ("Prove it by rerunning it on that unit and diffing against your hand-done version"). It sits at 4 rather than 5 because the sequence is spread across bullets rather than laid out as an ordered workflow, making the step order implicit. | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines with no need for external references and is organized into clearly labeled sections (Why, Pattern, Balance), which per the short-skill exception qualifies for 5. Cross-links to sibling principles ([Laziness Protocol], [Encode Lessons in Structure], [Prove It Works]) are clearly signaled and one level deep. | 5 / 5 |
Total | 18 / 20 Passed |