Content
50%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The skill is well-organized and instruction-only guidance is acceptable, but it is weakened by repeated principles, abstract actionability, a malformed code fence, and a missing explicit review workflow with validation checkpoints. Progressive disclosure is reasonable but leaves three reference files orphaned.
Suggestions
Collapse the overlapping Review Principles, Anti-Patterns, and Red Flags sections into a single concise block to remove repetition and improve token efficiency.
Replace abstract directives ('Find bugs', 'Findings First') with a concrete step-by-step review workflow ending in a validation checkpoint (e.g., 'confirm each finding cites file/test evidence before reporting').
Fix the malformed fenced code block in the Output Format section and link the orphaned reference files (lenses.md, report.md, request-template.md) or remove them.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly tight and assumes Claude's competence, but overlapping sections (Review Principles, Checklist, Anti-Patterns) repeat the same 'substance over style / findings first' message several times. | 2 / 3 |
Actionability | The output-format block and severity tags give concrete templates, but most guidance is abstract ('Find bugs, flaws, design errors', 'Findings First') with few executable specifics; the inline code fence is malformed. | 2 / 3 |
Workflow Clarity | Principles and a checklist are listed, but there is no ordered review workflow with validation checkpoints; destructive/batch-style claims ('Every substantive finding must include Why') are asserted without a verify step. | 2 / 3 |
Progressive Disclosure | The body points to references/checklist.md and references/output-format.md (both present), but three bundle files (lenses.md, report.md, request-template.md) are unlinked, and the main checklist is duplicated inline rather than cleanly split. | 2 / 3 |
Total | 8 / 12 Passed |