Content
86%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 is a lean, highly actionable process skill with a clearly staged workflow, pervasive test validation, and exemplary progressive disclosure via a single well-signaled reference file. The only weaknesses are minor: Code Style heuristics lack concrete examples, and test-failure recovery is left implicit. It compares favorably to the rubric's good overall examples.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is ~85 lines of terse, imperative bullets ("Remove dead code", "Extract paragraphs into methods", "Never change test assertions, test data, or test logic") with zero explanation of concepts Claude already knows. Every instruction is a directive, matching the anchor "lean and efficient; every token earns its place"; anchor 4 would require over-explanation that is not present. | 5 / 5 |
Actionability | Concrete, executable specifics abound: "Find or create ./test.sh, verify all tests pass", the commit format "- r <refactoring>", and exact announcement strings. However, Code Style heuristics such as "Look for opportunities to simplify" and "Use domain language - name things for what they ARE" lack before/after examples, fitting anchor 4 (mostly concrete guidance with minor gaps) rather than 5. | 4 / 5 |
Workflow Clarity | The staged sequence (Prep, Main Refactoring, Final Evaluation, Summary) is clear with validation at every step ("Ensure all tests pass" before and after each change) and an explicit final-evaluation loop ("Repeat until you find nothing more to improve"). It falls short of anchor 5 because test-failure recovery is only implicit (no "revert if tests fail" step) and "create ./test.sh" is underspecified — anchor 4's "minor validation gaps". | 4 / 5 |
Progressive Disclosure | Sections are well organized and the only language-specific detail is correctly offloaded to a clearly signaled, one-level-deep reference: "For Java: See [references/java.md](references/java.md)" (a real file containing the Java-specific guidance). This matches anchor 5's clear overview with well-signaled one-level-deep references; there is no inline content that belongs in a separate file. | 5 / 5 |
Total | 18 / 20 Passed |