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.
An exceptionally tight process skill: it converts debugging from vibes into a gated, checklisted pipeline built around one core discipline (a tight red-capable feedback loop), with concrete tooling, formats, and a real HITL script. The only structural nit is that the loop-construction catalogue is kept fully inline rather than externalized, which is a defensible but imperfect disclosure decision.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence throughout — e.g. "**Failing test** at whatever seam reaches the bug: unit, integration, e2e" and "**Tag every debug log** with a unique prefix, e.g. `[DEBUG-a4f2]`. Cleanup at the end becomes a single grep" convey maximal instruction in minimal tokens. It never explains concepts Claude already knows; even the aphoristic lines ("Untagged logs survive; tagged logs die") are compressed load-bearing guidance, not padding. | 5 / 5 |
Actionability | Guidance is concrete and executable: ten specific loop-construction strategies naming exact tools (curl, Playwright/Puppeteer, `git bisect run`), a copy-paste hypothesis format ("If <X> is the cause, then <changing Y> will make the bug disappear"), a concrete log-tag convention, and a real, runnable template at `scripts/hitl-loop.template.sh` (verified to exist). The one-command completion criterion gives an unambiguous, checkable exit condition for Phase 1. | 5 / 5 |
Workflow Clarity | Six phases are strictly sequenced with explicit gating checkpoints ("No red-capable command, no Phase 2", "Do not proceed until you have reproduced **and** minimised") and per-phase checklists. The workflow is itself a feedback loop (red loop → minimise → hypothesise → instrument → watch test fail/pass → re-run loop), and Phase 6's cleanup checklist (re-run loop, grep the DEBUG prefix, state the correct hypothesis in the commit message) provides end-to-end validation. | 5 / 5 |
Progressive Disclosure | Good structure: the single bundle file (`scripts/hitl-loop.template.sh`) is clearly signaled at its point of use, is one level deep, and exists; section headers make the ~130-line body navigable. The inline 10-item "Ways to construct one" list is borderline content that could live in a reference file, and no references/ split exists for it — a minor organization gap that keeps this just below the ideal split. | 4 / 5 |
Total | 19 / 20 Passed |