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 lean principle skill: every bullet is a concrete, memorable decision rule and the organization is clean with zero token waste. The only room for improvement is a brief worked example contrasting a lazy versus over-engineered diff to push actionability to fully executable-equivalent.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence: a two-sentence rationale ("Writing code is cheap for you... Counter it by borrowing a human maintainer's fatigue") followed by five terse bullets and a closing prime directive, with no padding or explanations of concepts Claude already knows — matching 'every token earns its place'. | 5 / 5 |
Actionability | Each bullet gives concrete, directive guidance with specifics — "more than 3 files or layers", "Put it behind one source of truth and pass the result as a simple flag", "Fewer lines beat 'elegant' boilerplate" — which is actionable for an instruction-only skill. It falls just short of fully executable-equivalent guidance because no worked example shows the heuristics applied, fitting 'Mostly executable guidance; concrete code or commands with minor gaps'. | 4 / 5 |
Workflow Clarity | This is a simple, single-purpose skill under 50 lines whose single action is unambiguous — each bullet is a self-contained decision rule, so the simple-skill exception applies. There are no destructive or batch operations, so the validation cap does not apply. | 5 / 5 |
Progressive Disclosure | The skill is under 50 lines with no need for external references, and the content is well-organized into a header, framing intro, bulleted principles, and a closing prime directive — matching the guideline that such skills can score 5 with just well-organized sections. No bundle files exist, so there are no buried or nested references to penalize. | 5 / 5 |
Total | 19 / 20 Passed |