Content
100%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 an exemplary instruction-style skill: lean and concrete, with a fully specified intake command, a well-sequenced tracing methodology containing its own validation loops, and a clean split between the overview and a real one-level-deep reference file. No dimension shows a meaningful gap.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~45-line body contains no filler and no explanation of concepts Claude already knows; every sentence carries skill-specific information (intake command, symptom-splitting policy, sub-agent delegation warning, output contract). It matches the score-5 anchor 'every token earns its place' — the score-4 anchor would require identifiable over-explanation to trim, and none is present. | 5 / 5 |
Actionability | The intake command is copy-paste ready with all flags and value forms (`--issue <N|url> | --jira <KEY|url> | --file <path> | --text "<report>"`), the trace steps name concrete tools with arguments (system-history `analyze.ts --focus` with every path file, `pr.ts --pr N --file <path>` in the reference), and the output section specifies exact enumerated fields and an evidence-level enum (`reproduced`, `traced`, `inferred`). This covers the common cases fully per the score-5 anchor. | 5 / 5 |
Workflow Clarity | A clear numbered sequence (intake → split symptoms → trace → output) with explicit validation checkpoints baked into the method: "Check every precondition against today's code", "Hold at least two explanations, and run the check that separates them", and "Reproduce in the branch browser" are feedback loops, and the evidence-level gate plus the output checklist close the loop. This matches the score-5 anchor; the tracing work is read-only, so the destructive/batch validation cap does not apply. | 5 / 5 |
Progressive Disclosure | Verified against the actual bundle: `references/bug-investigation.md` exists and is well-signaled ("Follow `references/bug-investigation.md`") one level deep with no nested reference chains, and `scripts/bug-intake.ts` exists and is invoked by exact path. The split is appropriate — overview and step summary in SKILL.md, the full investigation brief in the reference, the executable script in scripts/ — matching the score-5 anchor's clear overview with well-signaled one-level-deep references. | 5 / 5 |
Total | 20 / 20 Passed |