Content
81%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 highly actionable, well-sequenced orchestration skill with real, well-organized reference files and explicit validation. Its main weakness is repetition: several rules (skip justification, tool-preference mapping, evidence-first posture) are stated in multiple sections, and the body carries detail that could live in the references.
Suggestions
Consolidate the investigator-skip guidance into one place — it currently appears in the header note, 'When to skip an investigator', Troubleshooting, and 'NEVER skip an investigator because you assume its category won't have anything' — and cross-reference it from the others.
Merge the header note's code-graph-vs-raw-git mapping with Step 2's identical (and more complete) mapping, keeping a one-line pointer in the header.
Fold 'Operating Posture' into 'Core Epistemics' (both state 'Evidence before narrative' and hedging rules) and move the investigator-roster detail into a reference file, keeping only the one-line category list in the body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The guidance is operational and never explains concepts Claude already knows, but the same rules are restated several times: investigator-skip justification appears in the header note, 'When to skip an investigator', Troubleshooting, and the NEVER list; the code-graph-vs-raw-git mapping appears in both the header note and Step 2; 'Evidence before narrative' appears in both Operating Posture and Core Epistemics. This matches anchor 3 ('mostly efficient but... could be tightened') rather than 2 — the excess is repetition of skill-specific guidance, not background explanation or fluff. | 3 / 5 |
Actionability | Fully executable throughout: exact git commands ('git blame -L <start>,<end> <file>', 'git log --follow -p -- <file>'), a copy-paste-ready 'gh pr view <number> --json title,body,author,createdAt,mergedAt,labels,closingIssuesReferences,comments,reviews', tokensave tool signatures, explicit subagent config (subagent_type, model), a numbered per-investigator input checklist, and a worked Sources Consulted example. Anchor 5 — specific commands cover the common cases. | 5 / 5 |
Workflow Clarity | Steps 1–5 are clearly sequenced, and a dedicated Verification section supplies an explicit validation checkpoint ('spot-check at least one citation... Run this the same way you'd run a test before shipping'), with error-recovery feedback in Troubleshooting and Common Failure Modes (each with a WHY). Anchor 5: clear sequence, explicit validation, feedback loops. | 5 / 5 |
Progressive Disclosure | All cited references exist and are one level deep, clearly signaled both inline and in the Reference Files section, with references/source-playbook.md indexing references/sources/*.md — good structure matching anchor 4. Not anchor 5: the ~370-line body itself carries substantial detail (the full investigator roster, a summary of the epistemics framework that duplicates references/epistemics.md, and the long porting/precedence header note) that is closer to reference material than overview. | 4 / 5 |
Total | 17 / 20 Passed |