Content
88%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.
The body is a tight, highly executable playbook: concrete git commands, a five-part evidence gate with a feedback loop, explicit verdict categories, and a complete subagent brief template. Minor improvements possible in trimming the opening rationale and moving the brief template to a reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and assumes competence — no basic concepts are explained, and every step carries operational detail. It is not a 5 because the opening rationale paragraph and a few aphoristic asides ('a wrong invariant is cheaper to correct now than after the hunt') could be trimmed without losing guidance. | 4 / 5 |
Actionability | Concrete commands appear throughout ('git rev-parse', 'git log --oneline <fixed-point>..HEAD', 'git status --short', 'git diff plus new files via git add -N') and the Brief is a complete, copy-paste-ready subagent dispatch template whose angle-bracket placeholders are explicitly justified ('Replace the angle-bracket fields. Keep the rest.'). It fully matches the 5 anchor. | 5 / 5 |
Workflow Clarity | Six clearly sequenced steps with an explicit evidence gate (step 4's five-part finding requirement), a feedback loop ('Send anything less back with "reproduce or drop"'), verification requirements ('confirm the focused suites pass with them and that exactly your new tests fail without them'), and a done-when checklist. This matches the 5 anchor's validation steps, feedback loops, and checklist. | 5 / 5 |
Progressive Disclosure | Sections are well organized (Steps, Brief) with clearly signaled one-level cross-skill references (../code-review/SKILL.md, ../code-review/rules.md, ../pr/SKILL.md). It is not a 5 because the ~40-line brief template inlined in a >50-line skill could plausibly live in a bundle reference file, leaving SKILL.md a leaner overview. | 4 / 5 |
Total | 18 / 20 Passed |