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.
An exemplary terse instruction skill: every section earns its tokens, the output format and severity scheme are concrete and copy-pasteable, and the Auto-Clarity and Boundaries sections crisply scope exceptions without bloat. As a simple single-purpose skill under 50 lines with no bundle files, it satisfies the simple-skill exceptions for workflow clarity and progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean imperative prose with no explanation of concepts Claude already knows ('Write code review comments terse and actionable. One line per finding.'); even the verbose ❌ examples earn their place by demonstrating what to drop. | 5 / 5 |
Actionability | Copy-paste-ready output template (`L<line>: <problem>. <fix.>`), defined severity prefixes, explicit drop/keep lists, and three before/after example pairs covering bug, risk, and nit cases. | 5 / 5 |
Workflow Clarity | A simple single-purpose skill whose single action (produce terse one-line review comments) is unambiguous; per the simple-skill exception this scores 5, and the Auto-Clarity section cleanly scopes the exception. | 5 / 5 |
Progressive Disclosure | Under 50 lines with no external references needed and well-organized sections (Rules, Examples, Auto-Clarity, Boundaries); per the simple-skill exception this scores 5. | 5 / 5 |
Total | 20 / 20 Passed |