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 strongly operational skill: executable git/gh commands, precise subagent configuration, a well-sequenced five-step workflow with real validation gates, and a verified, clearly signaled reference bundle. Its main weakness is token efficiency — the epistemic guidance and skip rules are each stated two to three times — plus minor navigation duplication toward the source playbooks.
Suggestions
Merge "Operating Posture" and "Core Epistemics" into one section: 'Hedge on purpose' vs 'Prefer appears to over because', and 'Name the gaps' vs 'Acknowledge gaps' repeat the same guidance nearly verbatim; state each principle once.
State the never-skip-without-searching rule once (in Step 3's 'When to skip an investigator') and have the 'Skipping investigators by anticipation' failure mode reference it in one line instead of restating the rationale.
Trim the inline investigator roster to one or two lines per category (category → the kind of 'why' it uniquely surfaces) and move the fuller 'what to expect back' detail into the corresponding references/sources/<source>.md playbook, which also resolves the navigation duplication between source-playbook.md and SKILL.md's Reference Files section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient — concrete commands, no filler explaining concepts Claude already knows — but guidance is duplicated between "Operating Posture" ("Hedge on purpose", "Name the gaps") and "Core Epistemics" ("Prefer 'appears to' over 'because'", "Acknowledge gaps"), and the default-to-all-seven rule is stated three times (Step 3 intro, "When to skip an investigator", and "Skipping investigators by anticipation"). This is more than minor trimmable over-explanation (not 4), but it is dense and specific rather than padded (not 2). | 3 / 5 |
Actionability | Fully executable guidance throughout: copy-paste commands ("git log --follow -p -- <file>", "gh pr view <number> --json title,body,author,createdAt,mergedAt,labels,closingIssuesReferences,comments,reviews"), exact subagent spawn config (subagent_type, model defaults), a fully specified output format with concrete example "Sources Consulted" lines, and explicit reference files per role. Specific examples cover the common cases. | 5 / 5 |
Workflow Clarity | A clear five-step sequence (Understand → Code Anchor → Spawn Investigators → Synthesize → Present) with explicit validation checkpoints: skipping a category requires an "explicit, written justification" in the final output, inline answers are permitted only "after confirming all seven available category searches would be redundant", null results are documented in a coverage map, and the synthesizer's "quality check spot-verifies citations". Not 4: checkpoints are explicit, not mostly present. | 5 / 5 |
Progressive Disclosure | Good structure: a dedicated "Reference Files" section describes each bundle file's purpose, every referenced path (references/epistemics.md, investigator-prompt.md, synthesizer-prompt.md, source-playbook.md, sources/*.md) exists on disk, and references are one level deep with sources/*.md linked directly from SKILL.md. Not 5: navigation to the category playbooks is duplicated (both the source-playbook.md index and SKILL.md's direct listing), and the ~30-line inline investigator roster substantially overlaps the content that lives in the per-category references/sources/*.md playbooks — minor organization gaps. | 4 / 5 |
Total | 17 / 20 Passed |