Content
81%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-engineered body: a strictly ordered ten-step workflow with real validation gates and feedback loops, copy-paste-ready commands with documented flags, and clean one-level-deep reference structure indexed by a Files table. Its two weaknesses are rhetorical padding that inflates token cost without adding instruction, and bundle references (scenes demo pages, the library directory) that do not exist in the shipped files.
Suggestions
Trim the narrative passages (the model-defaults intro, the 'One warning learned in testing' paragraph, parenthetical anecdotes, and the 'Why these, honestly' rationale section) to single-line notes; the rules and tables already carry the instruction, so the body could shed a substantial share of its tokens without losing guidance.
Fix the dangling bundle references: either ship 'library/' and 'assets/scenes/demo/<id>.html' (referenced by the Files table, step 6, and draw.mjs's printed sheet) or remove/qualify those pointers so readers aren't sent to files that don't exist.
Move the sector/role/tone flag vocabulary and the app-screen fragment rules out of inline prose and into the existing reference files (copy.md, app-screens.md), keeping the run steps to commands and decision rules only.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with genuinely skill-specific rules (house rules table, numeric laws, exact CLI invocations) and wastes little on concepts Claude already knows, but it carries noticeable rhetorical padding that could be tightened without loss: the opening 'Nothing in it is wrong and nothing in it was decided' framing, the 'One warning learned in testing' narrative, parenthetical anecdotes ('the oven lit at five, the ferry at seven'; 'A camera that prints poems delivered its copy as paper slips'), and the 'Why these, honestly' rationale section. This fits the anchor 'mostly efficient but includes some unnecessary explanation or could be tightened' better than the score-4 anchor, whose over-explanation is only minor — here the trimmable prose runs to dozens of lines across the document. | 3 / 5 |
Actionability | Guidance is fully executable: copy-paste-ready commands with documented flags ('node <skill>/scripts/draw.mjs --sector <sector> --brief "..." --sections ... --options 3', '--redraw section:<role>=<id>', 'inspect.mjs <url> --out .taste-skill/before', 'assets.mjs --get <ref>', '--credits'), plus hard numeric thresholds (16px running text, 120–240px section gaps, ~32-character headlines, four-picture floor). The common cases — new page, app screen, redesign, no-network, no-Chrome — are each covered with specific instructions. | 5 / 5 |
Workflow Clarity | The ten-step run is explicitly ordered ('Do these in order') with validation checkpoints and feedback loops throughout: step 7's gate ('Fix every FAIL... Re-run until there are no FAILs. Do not argue with the meter'), step 8's critique-fix-reinspect loop bounded at three rounds, and step 10's pre-report checklist ('Do not report until all of these are true'). This matches the top anchor: clear sequence, explicit validation, error-recovery loops, and a checklist. | 5 / 5 |
Progressive Disclosure | Structure is strong: the body is an overview plus the core run, detail is pushed one level deep into eleven clearly named reference files, each signalled inline at its point of use ('Read that file whole before you start', 'references/motion.md has the tokens and tested recipes') and indexed in a Files table with a 'Read it when' column. However, scored against the actual bundle, two referenced paths are dangling: 'assets/scenes/demo/<id>.html' ('a working example of each') and the 'library/' directory the Files table and scripts both point to — neither exists in the bundle, so a reader following the sheet's pointers hits missing files. This fits 'good structure; references mostly clear; minor organization gaps' rather than the top anchor. | 4 / 5 |
Total | 17 / 20 Passed |