Content
78%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 tight, well-sectioned principle skill that teaches a clear per-unit verify-then-advance workflow with an explicit delivery ordering, and it respects the reader's intelligence throughout. Its residual gaps are an implicit on-red recovery step, no worked example of the canonical commit stack, and minor rhetorical redundancy in the Why paragraph.
Suggestions
Add an explicit error-recovery step to the Execution section (e.g., 'If a unit's check fails, fix it before starting the next unit') to close the feedback loop for batch operations.
Include a short worked example of the canonical delivery shape — e.g., a 2-commit stack showing the failing test first, then the fix — to make the 'red, then green' pattern concrete.
Tighten the Why paragraph by dropping the redundant 'you have already built further on a broken base' clause, which restates the preceding sentence.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The 17-line body is lean, assumes competence, and adds only non-obvious insight (ordering delivery so a reviewer can replay the argument); no padding explaining concepts Claude already knows. Not 5: the Why paragraph's second clause ("you have already built further on a broken base") restates the first, and rhetorical flourishes ("watch it go red, then green") could be trimmed. | 4 / 5 |
Actionability | Concrete, unambiguous directives throughout: "Rebase onto clean trunk first", "Never batch the edits and verify once at the end", "the failing test first, then the fix on top", "a subtraction before the reshape, a baseline capture before the treatment". Not 5: there is no worked example (e.g., a sample commit stack showing red-then-green) to make the canonical shape copy-paste concrete. | 4 / 5 |
Workflow Clarity | The core sequence is explicit with validation checkpoints: "known-good state, one change, run the check, then proceed" and "don't advance until the current one is green" — validation is central, so the batch-operation cap does not apply. Not 5: the on-red recovery loop (what to do when a unit's check fails) is only implied ("cheap to localize") rather than given as an explicit fix-then-proceed step. | 4 / 5 |
Progressive Disclosure | The skill is under 50 lines with no need for external references (no bundle files exist), and the body is cleanly sectioned into Why, Execution, Delivery, and Pattern with a well-signaled cross-reference to the two sibling principle skills — matching the simple-skill exception for a top score. | 5 / 5 |
Total | 17 / 20 Passed |