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 instruction-only skill body: lean, concrete, and immediately actionable, with specific word lists, a before/after example, and a defined output format. It fully meets the simple-skill exceptions for workflow clarity and progressive disclosure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~43-line body is lean: every rule is 1-3 lines, filler is handled by naming deletable words ('just', 'simply', 'basically', 'in order to') rather than explaining why, and no concept Claude already knows is taught. Matches 'every token earns its place'; there is no over-explanation to trim for anchor 4. | 5 / 5 |
Actionability | Instruction-only skill with concrete, executable guidance: a specific deletable-word list, a before/after error-message rewrite ('Config not found at ./app.config.ts. Create it or pass --config <path>.' beats 'Error: config missing'), and a specific AI-slop tell list. Per the rubric's code-vs-instruction note, absence of code is not penalized when guidance is this actionable. | 5 / 5 |
Workflow Clarity | Simple single-purpose skill under 50 lines: the single action (apply the rules when writing or editing prose) is unambiguous, and the Output section specifies the deliverable ('show the tightened version and, on request, a one-line note per change'). No destructive or batch operations, so the validation cap does not apply. | 5 / 5 |
Progressive Disclosure | Under 50 lines with no need for external bundle files, so well-organized sections alone satisfy the rubric: four clear sections (Rules, Error messages and UI copy, AI-slop tells, Output) and the one cross-skill reference (domain-modeling's CONTEXT.md) is clearly signaled. | 5 / 5 |
Total | 20 / 20 Passed |