Content
92%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 exemplary instruction-only skill: a tightly sequenced five-phase workflow with explicit validation checkpoints and feedback loops, written in dense directive prose with zero padding. Its only gap is the absence of worked examples for key artifacts (predicate, log row) and its reliance on external sibling skills for sub-step detail.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean, directive prose that assumes competence throughout — it never explains what a hypothesis loop, worktree, or todolist is, and lines like 'Rigor is gates and artifacts, not "try harder"' compress policy into single sentences. Matches 'lean and efficient; every token earns its place'; the only candidate for trimming is the intro sentence restating the description. | 5 / 5 |
Actionability | Phases give concrete directives ('Open a todolist whose first item is...', 'State the hypothesis, make the smallest change, measure against the predicate', verdicts 'VERIFIED, NOT VERIFIED, or INCONCLUSIVE'), so guidance is mostly executable. Not 5 because there are no worked examples (of a falsifiable predicate, a log row, or a framing) and sub-steps delegate to external skills without local detail. | 4 / 5 |
Workflow Clarity | A clear Start-then-Phase-A-through-E sequence with explicit validation ('verifying each unit before starting the next', 'Check the whole against the Phase A predicate on the real product') and feedback loops ('keep it if it advanced, revert it if it didn't'; harden the gate when a worker games it). Matches the top anchor; no destructive/batch cap applies. | 5 / 5 |
Progressive Disclosure | The body is under 50 lines with well-organized sections (Start, Phases A-E) and no content that belongs in a separate file; the single file reference (../../docs/harness/claude-code.md) is one level deep and clearly signaled. Under the simple-skill guideline, well-organized sections alone merit the top score; no bundle files exist to restructure. | 5 / 5 |
Total | 19 / 20 Passed |