Content
100%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.
Model instruction content: lean and token-efficient, fully actionable with a copy-paste scaffold, exact project APIs, and commands, plus an explicit validation loop and a done-when checklist. Delegating the full pattern to the water-cannon example file keeps it complete without padding.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line carries project-specific information — paths, APIs, commands, constraints — with zero conceptual padding, and it delegates the pattern rather than re-explaining it ("Read `src/games/water-cannon/game.ts` first: it is the pattern to copy"). Nothing to trim, so the score-4 anchor ("minor instances of over-explanation") does not apply. | 5 / 5 |
Actionability | Fully concrete guidance: exact paths (`src/games/<game-id>/`, `src/games/index.ts`), specific APIs (`recordScore(ringToss.id, score)` from `src/carnival`, `theme.colors.*`, `canvasFont(...)`), commands (`npm run format`, `npm run check`, `npm run dev`), and a copy-paste-ready `CarnivalGame` export scaffold. The placeholder comments inside `start()` are explicitly justified flexibility — each game's loop is inherently different, and the water-cannon file is the complete worked example. | 5 / 5 |
Workflow Clarity | Ten clearly sequenced steps in a sensible order with an explicit validate-and-fix feedback loop ("Run `npm run format`, then `npm run check`, and fix anything it reports"), optional manual verification ("run `npm run dev`, walk to the new booth and play a round"), and a "Done when" checklist of three verifiable outcomes. This matches the top anchor (explicit validation steps, feedback loops, checklists); the operation is additive, not destructive or batch, so no cap applies. | 5 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent), and this ~55-line self-contained body has clean sections (intro, Steps, Done when) with a single clearly-signaled external pointer to the canonical pattern file. Per the simple-skill guidance, a short skill with no need for external references scores 5 with well-organized sections; there is no inlined content that belongs in a separate file, so the score-4 anchor's "minor organization gaps" does not apply. | 5 / 5 |
Total | 20 / 20 Passed |