Content
92%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 well-crafted process skill: a clearly gated six-phase workflow with checklists, feedback loops, and concrete heuristics throughout, plus a correctly signaled one-level-deep script reference that exists in the bundle. The only weakness is minor over-explanation in the Phase 6 architectural hand-off paragraph and the closing provenance note.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence ('A 30-second flaky loop is barely better than no loop', 'One breakpoint beats ten logs') with no padding about known concepts. However, the Phase 6 hand-off paragraph explaining /improve-codebase-architecture in detail and the provenance footer are minor instances of over-explanation that could be trimmed, matching anchor 4 rather than 5. | 4 / 5 |
Actionability | Guidance is fully actionable: ten concrete loop-construction strategies ('run 1000 random inputs', 'diffing stdout against a known-good snapshot'), a fill-in hypothesis template ('If <X> is the cause, then <changing Y> will make the bug disappear'), a concrete debug-log tag scheme ('[DEBUG-a4f2]', 'Cleanup at the end becomes a single grep'), and a real copy-paste-ready script at scripts/hitl-loop.template.sh. Per the rubric's scoring note, the absence of inline code in this instruction-only skill is not penalized because the directives are specific and executable. | 5 / 5 |
Workflow Clarity | Six explicitly sequenced phases with hard gates ('Do not proceed to Phase 2 until you have a loop you believe in'), checklists in Phase 2 and Phase 6, and explicit feedback loops (watch the regression test fail, apply the fix, watch it pass, re-run the Phase 1 loop against the un-minimised scenario). This matches anchor 5: clear sequence with explicit validation steps, feedback loops, and checklists. | 5 / 5 |
Progressive Disclosure | Well-organized phase sections; the single bundle file is referenced exactly where needed ('drive _them_ with .claude/skills/diagnose/scripts/hitl-loop.template.sh') and resolves to the real scripts/hitl-loop.template.sh, one level deep. Core process content is appropriately inlined and navigation is easy, matching anchor 5. | 5 / 5 |
Total | 19 / 20 Passed |