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.
An exemplary lean skill body: dense rule statements with no filler, a copy-paste-ready trace command, and a procedure with genuine validation checkpoints (docs-first check, record-before-delete, timebox stop condition). Organization suits its size perfectly — no bundle files are needed and none are missing.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~28-line body is dense and every line carries non-obvious policy (scratch-dir placement, suspension of the test-first rule, trace no-op behavior, version-citation requirement) with zero explanations of concepts Claude already knows. The rule-4 parenthetical justifies a governance exception rather than padding, so nothing is trimmable as the 4 anchor would require. | 5 / 5 |
Actionability | Provides a copy-paste-ready command ('sh scripts/trace.sh emit kind=spike.verdict [subject=...] outcome=true|false|inconclusive --blob <file> ... || :'), concrete destinations ('docs/diary.md', session scratchpad or $TMPDIR), and a worked falsifiable-question example — fully executable guidance for an instruction-only skill. | 5 / 5 |
Workflow Clarity | The procedure is clearly sequenced with explicit checkpoints: docs-first check (step 1), evidence capture (step 3), record-before-delete ordering protecting the one destructive operation (step 4), and a timebox feedback loop ('A spike that runs long is answering a different, bigger question — stop and say so') plus an inconclusive outcome path. This matches the 5 anchor's explicit-validation-and-recovery profile; the destructive delete is validated by recording the finding first, so the score-3 cap does not apply. | 5 / 5 |
Progressive Disclosure | The skill is under 50 lines, needs no external reference files (none exist in the bundle), and is cleanly organized into a title, orienting intro, Rules, and Procedure sections — meeting the rubric's simple-skill criterion for a 5. External paths mentioned (constitution/local-engineering.md, docs/diary.md, scripts/trace.sh) are project files, not skill-bundle references, and the trace call degrades to a silent no-op when unconfigured. | 5 / 5 |
Total | 20 / 20 Passed |