Content
70%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 skill delivers a well-sequenced, genuinely actionable review workflow with explicit validation steps and severity labeling — its strongest qualities. Its weaknesses are length and repetition (the same principles are restated across four-plus sections, including basics Claude already knows) and a monolithic structure whose only external references point to files that do not exist in the bundle.
Suggestions
Move the Dependency Discipline upgrade workflow, Common Rationalizations table, and Red Flags list into a reference file (e.g., references/review-heuristics.md) and link them from the body, trimming the main SKILL.md substantially.
Fix or remove the broken 'See Also' paths ('../../references/security-checklist.md', '../../references/performance-checklist.md') — they point outside the skill directory and no such files exist in the bundle; either ship them as proper one-level-deep bundle references or drop the section.
Deduplicate recurring principles (refactor-relocates-complexity, one-dependency-per-change) by stating each once and cross-referencing, and cut universal checks like parameterized SQL and XSS encoding that Claude already applies by default.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and opinionated rather than padded, but at ~400 lines it repeats the same guidance in multiple sections: the 'refactor relocates complexity' idea appears in Architecture, Structural Remedies, Common Rationalizations, Red Flags, and Verification, and 'one dependency per change' likewise recurs four times. It also spends tokens on checks Claude already knows (parameterized SQL, XSS output encoding), fitting 'mostly efficient but could be tightened' (3) rather than the more severely padded level 2. | 3 / 5 |
Actionability | For an instruction-only skill, the guidance is concrete and executable: a severity-label table, a copy-paste dead-code report template, an example review-agent prompt, and a runnable mutation-check procedure ('Invert one condition the change adds (drop a negation, swap && for ||), run the suite, then restore the file from a copy'). Not 5 because the five-axis bullets remain judgment-level checklists rather than fully worked examples of findings. | 4 / 5 |
Workflow Clarity | A clear five-step review process is explicitly sequenced with validation checkpoints: review tests first with a mutation experiment, check findings against callers/guards/tests before reporting, verify the author's verification story, and a final verification checklist with escalation rules. This matches the 5 anchor (explicit validation steps, feedback loops, checklists); this is a review skill, not a destructive/batch operation, so no cap applies. | 5 / 5 |
Progressive Disclosure | The body has clear section headers, but no bundle files exist (no references/, scripts/, or assets/), and the 'See Also' section points to '../../references/security-checklist.md' and '../../references/performance-checklist.md' — paths outside the skill directory with no corresponding files in the bundle. Substantial content that belongs in separate reference files (the dependency-upgrade workflow, Common Rationalizations table, Red Flags) is inlined in an already ~400-line SKILL.md, fitting 'some structure but could be better organized; references present but not clearly signaled' (3). | 3 / 5 |
Total | 15 / 20 Passed |