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.
A dense, fully operational skill body: executable commands with exit-code semantics, a worked sidecar example, explicit gate and hard rules with validation and escalation, and well-signaled one-level-deep references. It respects the token budget while remaining unambiguous about what to do and what never to do.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is maximally lean: every line carries operational content (exit codes, severity names, gate conditions, hard rules) and nothing explains concepts Claude already knows. It matches the "every token earns its place" anchor; the closing provenance paragraph is licensing/design justification rather than padding, so it is not a 4. | 5 / 5 |
Actionability | The sh block gives copy-paste-ready commands with flags and exit semantics ("python3 $S/human_gate.py open plan.md --launch", "close plan.md # exit 2 = NOT done"), plus a concrete sidecar worked example and "human_gate.py --sample" to exercise the whole loop. It is not a 4 because the common cases (open/status/collect/close/waive) are all covered executably. | 5 / 5 |
Workflow Clarity | The loop is clearly sequenced (open → status → collect → close) with explicit validation checkpoints: exit-2 refusal, G1–G7 gate rules, round-cap escalation, and the G7 integrity check for mistyped severities. Feedback loops are explicit (collect applies every item; close names what is open), matching the score-5 anchor rather than 4. | 5 / 5 |
Progressive Disclosure | The body is a well-sectioned overview with one-level-deep references, each signaled with its purpose: "Reasoning lives in references/ — human-in-the-loop canon, feedback batching, loop discipline", "Worked example and JSON contract are in assets/", and conditional "Read human-gate-context.md first if it exists". Note: no bundle files are present in this evaluation copy, so this is scored on the body's structure and signaling, which match the score-5 anchor; it is not a 4 because every reference is clearly named and motivated. | 5 / 5 |
Total | 20 / 20 Passed |