Content
92%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 router skill: concrete commands and paths, a clear ordered routing table with explicit fallback rules, and tight well-organized sections with no padding. The only blemish is slight redundancy between the Invocation/Non-goals/Bounds sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence, but the 'Invocation' section restates the frontmatter's explicit-only stance and 'Non-goals' overlaps with 'Bounds' (both forbid guessing/inventing), giving minor trimmable redundancy rather than the flawless token economy of a 5. | 4 / 5 |
Actionability | It gives fully executable, specific guidance: concrete slash commands ('/help', '/skills inspect', '/skill <name>', '/config'), the exact command 'codewhale-tui doctor', named doc paths, and the precise tool ('File with action: "read"'), covering the common routing cases. | 5 / 5 |
Workflow Clarity | The numbered routing table gives a clear ordered sequence with an explicit priority ('in this order') and decision rules act as checkpoints ('the surface wins', 'say so and stop'); as a non-destructive router the validation cap does not apply and the simple-skill exception holds. | 5 / 5 |
Progressive Disclosure | A simple single-purpose skill under 50 lines with no bundle files, organized into well-labeled sections and pointing one level deep to checkout docs ('docs/SKILLS.md', 'docs/CONFIGURATION.md') that are clearly signaled, matching the simple-skill exception for a 5. | 5 / 5 |
Total | 19 / 20 Passed |