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.
This is a strong process skill: lean and imperative with zero filler, concrete and runnable guidance at every phase, explicit validation gates between phases, and a correctly factored bundle (one referenced script that exists and is used as described). The discipline framing (tight red-capable loop as the core deliverable) is consistently enforced with checklists and completion criteria.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, imperative, and assumes Claude's competence throughout — e.g. "Spend disproportionate effort here", "Cut inputs, callers, config, data, and steps one at a time", "Untagged logs survive; tagged logs die". No section explains concepts Claude already knows; rationale lines ("Wrong bug = wrong fix", "Why bother: a minimal repro shrinks the hypothesis space") are minimal and load-bearing, matching anchor 5 rather than anchor 4's 'minor instances that could be trimmed'. | 5 / 5 |
Actionability | Guidance is concrete and executable at every step: a ranked list of 10 loop-construction tactics (failing test, curl script, "run 1000 random inputs", "`git bisect run` it"), a real script path (`scripts/hitl-loop.template.sh`, which exists in the bundle), a concrete log-tag convention (`[DEBUG-a4f2]` with "Cleanup at the end becomes a single grep"), and a falsifiable-hypothesis format string. For an instruction-only skill this is fully specific guidance with copy-paste-ready artifacts, matching anchor 5. | 5 / 5 |
Workflow Clarity | Six phases are clearly sequenced with explicit validation gates and checklists: "No red-capable command, no Phase 2", "Do not proceed until you have reproduced and minimised", a 4-item red-capable checklist, "Watch it fail / Apply the fix / Watch it pass / Re-run the Phase 1 loop", and a Phase 6 cleanup checklist. This is the anchor-5 pattern (explicit validation steps, feedback loops, checklists) with no gaps that would place it at 4. | 5 / 5 |
Progressive Disclosure | The body is a well-sectioned overview whose only bundle dependency — `scripts/hitl-loop.template.sh` — is clearly signaled, one level deep, and verified to exist with content matching its description (step/capture helpers, KEY=VALUE output). All inline content (phases, checklists, construction tactics) is the core instruction and appropriately belongs in SKILL.md; navigation via phase headers is easy, matching anchor 5. | 5 / 5 |
Total | 20 / 20 Passed |