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 exemplar of a lean protocol skill: a clear use/not-use trigger, an input contract with an early exit, a sequenced procedure with built-in verification and escalation paths, hard guardrails against motivated stopping, and a concrete output record. The only notable gap is that the proof-log format and full method live in external files not present in the bundle, which slightly limits standalone executability.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and directive throughout — 'Do not reveal candidate text, scores, or private reasoning across generators. Assign an opaque identifier to every generated candidate.' — with zero explanations of concepts Claude already knows and no padded passages. Every line instructs or constrains, matching the 'every token earns its place' anchor. | 5 / 5 |
Actionability | Concrete, executable guidance dominates: exact return values ('return needs_contract', 'PASS, FAIL, or UNKNOWN'), a copy-paste BEST-OF-N RESULT output template, and specific mechanics like isolated worktrees 'from the same base revision' and capturing 'commands, output location, exit status, artifact hash or revision'. Not 5 because the full method and the proof-log template are delegated to external files outside the skill bundle, so a reader must chase those to fully execute. | 4 / 5 |
Workflow Clarity | The eight-step procedure is clearly sequenced with explicit validation checkpoints and feedback loops: contract freezing before generation, the needs_contract early exit, executable checks with recorded exit status, reviewer escalation 'If executable verification cannot decide the requirement', and UNKNOWN blocking verified claims. An input checklist and a guardrails section round out a full error-recovery loop. | 5 / 5 |
Progressive Disclosure | The ~50-line body is well organized into focused sections and appropriately delegates detail through clearly signaled one-level-deep links: 'Read the full method at [Best-of-N: Generate, Select, and Verify]', the TESTING.md proof-log template, and a Connections section of related guides. There is no inlined content that belongs in a separate file. | 5 / 5 |
Total | 19 / 20 Passed |