Content
60%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 well-structured, actionable review-prompt skill with concrete thresholds, phrases, and remedies. Its main weakness is verbosity: the same core concepts are restated across several large sections, inflating the token budget without adding new guidance.
Suggestions
Consolidate the repeated code-judo, 1k-line, spaghetti, wrapper, and cast themes into a single section; currently they reappear in 'Non-Negotiable Standards', 'What to Flag Aggressively', 'Preferred Remedies', and 'Approval Bar'.
Trim 'What to Flag Aggressively' and 'Preferred Remedies' to the highest-value items, since most map one-to-one onto rules already stated above.
Cut generic exhortations like 'be ambitious' and 'be extremely thorough' that assume little of Claude, or fold them once into the Core Prompt.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is noticeably verbose and heavily repetitive: the code-judo idea, the 1k-line rule, spaghetti branching, wrappers, and casts each reappear across 'Non-Negotiable Standards', 'Primary Review Questions', 'What to Flag Aggressively', 'Preferred Remedies', and 'Approval Bar', restating the same concepts 3-4 times. | 2 / 5 |
Actionability | For an instruction-only review skill the guidance is concrete and actionable — a hard 1000-line threshold, copy-paste-ready 'good phrases', and a specific list of preferred remedies — though some directives remain abstract ('be ambitious', 'be extremely thorough'). | 4 / 5 |
Workflow Clarity | There is no multi-step transformation workflow, but the single review action is unambiguous and the 'Output Expectations' section provides a clear 1-7 priority sequence for findings; no validation checkpoint is needed since the skill produces comments rather than mutating code. | 4 / 5 |
Progressive Disclosure | The file is self-contained with clear, well-labeled section headers and no external references (none exist), making navigation easy; minor gaps come from the length and repetition that could be consolidated into a tighter overview. | 4 / 5 |
Total | 14 / 20 Passed |