Content
96%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 strong operational skill body: executable end-to-end quick start, machine-checkable validation gates, explicit retry/escalate feedback loops, and lean token-efficient prose. The only gap is that the referenced bundle files (references/, scripts/, assets/) are absent from the provided directory, so progressive disclosure cannot be verified against the actual bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and dense: a contract diagram, copy-paste quick start, hard rules that each state a novel harness-specific invariant ("Never adjudicate your own verification", "Retry means a changed approach"), and exit-code/forcing-question tables. No padding and no explanation of concepts Claude already knows. Not 4: no section reads as trimmable over-explanation; even the "Why (canon)" column carries non-obvious rationale. | 5 / 5 |
Actionability | Fully executable: exact commands with arguments for the whole lifecycle (goal_compiler → loop_controller init/next/record/verify/close), expected JSON directive output, an exit-code table to branch on mechanically, and a "Verifiable success" section with concrete self-test cases including the failure path (vague goal exits 3). Copy-paste ready and covers the common cases. | 5 / 5 |
Workflow Clarity | The sequence is explicit with validation checkpoints baked in: the controller runs checks itself via subprocess, close is refused (exit 4) while any task is unverified, a failed verify consumes an attempt and requires a changed approach on retry, and exhausted budgets escalate rather than fake success. Forcing questions act as a pre-compile checklist. Matches the anchor: explicit validation, feedback loops for error recovery. | 5 / 5 |
Progressive Disclosure | The body is overview-level with three clearly signaled, one-level-deep references (references/verification_discipline.md, references/agentic_loop_canon.md, references/domain_harness_design.md), each attached to a specific purpose — good structure. Not 5: no bundle files are present in this skill directory, so the referenced references/, scripts/*.py, and assets/harnesses/ paths cannot be verified to exist and the appropriateness of the split cannot be confirmed. Not 3: the signaling and inline-vs-split judgment within the body itself are clean. | 4 / 5 |
Total | 19 / 20 Passed |