Content
73%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 delivers highly concrete, well-sequenced review guidance — a severity taxonomy, change-size thresholds, a mutation-testing verification procedure, ready-to-use checklists and templates — with excellent actionability and workflow clarity. Its weaknesses are structural: a ~395-line monolithic file whose only two file references are broken ('../../references/security-checklist.md' and '../../references/performance-checklist.md' do not exist in the bundle), plus repetition across the Rationalizations, Red Flags, and axis sections and some generic checklist content Claude already knows.
Suggestions
Create actual references/security-checklist.md and references/performance-checklist.md files, move the inline Security and Performance checklists into them, and fix the broken '../../references/' paths — they currently point outside the skill directory at files that do not exist.
Deduplicate content repeated across 'Common Rationalizations', 'Red Flags', and the five-axis sections (e.g., the refactor-relocates-complexity and file-size points each appear three times) to cut token usage.
Trim generic review heuristics Claude already knows from the axis bullet lists ('Are SQL queries parameterized?', 'Any N+1 query patterns?'), keeping the skill's non-obvious judgment calls and structural remedies.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly dense, opinionated guidance that earns its place (severity taxonomy, change-size thresholds, dependency upgrade discipline), but the five-axis bullet lists restate generic review heuristics Claude already knows ('Are SQL queries parameterized?', 'Any N+1 query patterns?', 'avoid nested ternaries'), and the same ideas recur across sections — refactor-relocates-complexity and file-size concerns each appear in the Architecture section, 'Common Rationalizations', 'Red Flags', and the final checklist. This fits anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened'); not 2 because there is no padded fluff or concept exposition, but the duplication and generic checklist content exceed the 'minor instances' bar of 4. | 3 / 5 |
Actionability | Fully executable, copy-paste-ready artifacts throughout: the severity prefix table ('Critical:' / 'Nit:' / 'Optional:' / 'FYI'), concrete size thresholds ('~100 lines changed → Good'), a precise mutation-testing procedure ('Invert one condition the change adds (drop a negation, swap && for ||), run the suite, then restore the file from a copy'), a ready review-agent prompt, a fill-in dead-code report template, and a complete review checklist. Specific examples cover the common review cases; no significant gaps for an instruction-only skill. | 5 / 5 |
Workflow Clarity | The Review Process is a clearly sequenced five-step workflow (understand context → review tests first → review implementation → categorize findings → verify the verification) with explicit validation checkpoints: the Step 2 mutation experiment, the Step 5 verification-story check, and the closing Verification checklist. Feedback loops are present ('A mutation that stays green is a finding: name the test case that is missing'), and the dead-code section adds an ask-before-deleting guard. This matches anchor 5 — clear sequence, explicit validation, feedback loops, and checklists for a complex process. | 5 / 5 |
Progressive Disclosure | The skill is a single ~395-line monolithic SKILL.md: no references/, scripts/, or assets/ directories exist, yet the 'See Also' section points to '../../references/security-checklist.md' and '../../references/performance-checklist.md' — broken paths that also escape the skill directory two levels up. Detailed checklists that the skill itself defers to other skills ('For detailed security guidance, see security-and-hardening') remain fully inlined. This fits anchor 2 ('content that clearly belongs in separate files is inlined'); it cannot reach 3 because beyond the inlining, the only file-level references are broken, leaving no working navigation to deeper material. | 2 / 5 |
Total | 15 / 20 Passed |