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 lean, well-structured instruction skill: every token earns its place, the rules are concrete and project-specific, and the procedure is clearly sequenced with genuine checkpoints. It sits just below top marks on actionability and workflow clarity only for unspecified timebox limits and the absence of a recovery path for inconclusive spikes.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every rule carries project-specific constraints (scratchpad dir, `docs/diary.md`, `constitution/local-engineering.md`, timebox, no-promotion) with no explanation of concepts Claude already knows; the one justificatory parenthetical in rule 4 is load-bearing, not padding. | 5 / 5 |
Actionability | Concrete, executable guidance for an instruction-only skill: "use the session scratchpad directory (or `$TMPDIR`)", a worked example of a falsifiable question, "Write the answer (question, verdict, evidence, surprises) into `docs/diary.md` as a dated entry", and a report format. Minor gaps: the timebox ("a spike that runs long") and step 2's "smallest program" leave scope and limits unspecified. | 4 / 5 |
Workflow Clarity | The Procedure is a clear four-step sequence with real checkpoints — the question-phrasing gate ("If you can't phrase the question, you're not ready to spike"), the docs-first check, and the timebox stop rule. Not a 5 because there is no recovery path for ambiguous or inconclusive spike results, and no explicit validation of the captured evidence before recording it. | 4 / 5 |
Progressive Disclosure | A sub-50-line, single-purpose skill with two well-organized sections (Rules, Procedure) and no need for external references — no references/, scripts/, or assets/ bundle exists, and the files mentioned (`docs/diary.md`, `constitution/local-engineering.md`) are project artifacts, not skill bundle paths, so the simple-skill exception applies. | 5 / 5 |
Total | 18 / 20 Passed |