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.
Exemplary skill body: executable commands throughout, an explicit state-machine workflow with controller-enforced verification and retry/escalation feedback loops, and clean progressive disclosure into real reference, script, and asset files. Nothing explained that Claude already knows, and nothing padded.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence: no concept explanations, just the contract diagram, quick-start commands, hard rules, forcing questions, and exit-code tables. Every section is operational and earns its tokens, matching the 'every token earns its place' anchor rather than merely having 'minor instances of over-explanation'. | 5 / 5 |
Actionability | Fully executable, copy-paste-ready commands with real flags for the full lifecycle: goal_compiler with --goal/--manifest/--out, loop_controller init/next/record/verify/close, and harness_manifest_builder regeneration, plus a concrete example goal. The exit-code table and 'Verifiable success' checks give mechanical branching for the common cases. | 5 / 5 |
Workflow Clarity | The multi-step loop is clearly sequenced as a state machine (GOAL → PLAN → [execute → verify]* → CLOSE) with explicit validation checkpoints — the controller runs checks itself, close is refused (exit 4) while tasks are unverified, evidence is required — and feedback loops for error recovery (retry consumes attempts, exhausted budgets escalate). This is the full anchor-5 pattern. | 5 / 5 |
Progressive Disclosure | The body is a well-organized overview that clearly signals one-level-deep references — verification_discipline.md, agentic_loop_canon.md, and domain_harness_design.md are each linked with a stated purpose — and all referenced paths (3 references, 3 scripts, 20 manifests under assets/harnesses/) actually exist in the bundle. Navigation is easy and content is appropriately split. | 5 / 5 |
Total | 20 / 20 Passed |