Content
88%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.
The body is an unusually disciplined operational document: exact commands, signatures, numeric bounds, and a fully validated workflow with explicit pass/fail gates and feedback loops. Its only weaknesses are verbose narrative in the examples section and bundle references (kit/, examples/) that don't resolve in the shipped files. It is among the more actionable skill bodies the rubric's top anchors describe.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The core guidance is maximally dense and assumes competence — "Solids, not wireframes", "bevels of 0.4–1.6, grooves inset 3–5 from an edge", no elementary explanation of SVG or isometric projection. The one padded area is the examples section, where narrative vignettes ("A quarter flies into the slot, rolls down the coin chute at the speed a rolling disc reaches on a 30° slope") describe outcomes at length rather than instruct; trimming those to the teaching point of each example would fit anchor 5. Not anchor 3: the vast majority of tokens are actionable instructions, not explanation Claude already knows. | 4 / 5 |
Actionability | Fully executable throughout: copy-paste-ready bash blocks ("cd "$WORK/figures/dial-indicator" && node build.mjs && node build.mjs --light"), exact commands with flags and outputs ("node scripts/lines.mjs page.html --out shots/lines.png"), exact function signatures ("fitProjection(points, width, height, { pad, azimuth })", "A.recorder(P, { order, spring })"), and precise numeric bounds for every craft rule. This matches anchor 5 ("Fully executable; copy-paste ready code or commands; specific examples cover the common cases"). | 5 / 5 |
Workflow Clarity | A clearly sequenced 10-step workflow with explicit validation checkpoints and pass conditions: "Run the audit to zero" ("must end `audit passed`, every failing line at 0"), "Run the line check to zero" ("must print `line ends: 0`"), "Read every PNG you make with `vision_analyze`". Feedback loops are explicit ("Iterate until yes", "Fix an interlock in the geometry, never with a key bias"), and step 1 adds time-boxing and user escalation ("when a step runs past twice its share of the estimate, tell the user where it stands"). This is anchor 5's clear sequence + explicit validation + error-recovery loops + checklist (references/verify.md). | 5 / 5 |
Progressive Disclosure | Structure is strong: a dedicated References section signals all eight one-level-deep files with read-when guidance ("Read it before designing", "Read `references/webgl.md` before writing any shader", "Read `references/3d.md` first"), and bulk detail (API, craft recipes, verification) is correctly split out of SKILL.md. However, against the actual bundle the body references paths that are not present — every `kit/*` file in the Setup table (`kit/lathe.mjs`, `kit/tube.mjs`, `kit/audit.mjs`) and all `examples/*` directories — so a reader following the quick-start commands would hit missing files. That gap keeps it below anchor 5; it stays above anchor 3 because the references that do exist are complete, well-signaled, and shallow. | 4 / 5 |
Total | 18 / 20 Passed |