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: dense, concrete, well-organized, and free of padding, with explicit when-to-apply conditions on each directive. The only minor gap is the absence of an inline code example of a branded type, which is acceptably delegated to a sibling skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and lean with zero padding — every sentence is either a directive ('Make the compiler reject impossible states, mismatched primitives, and unhandled variants') or a trigger condition ('If two arguments share a primitive type but mean different things, brand them'). It assumes Claude's competence and never explains basics Claude already knows. | 5 / 5 |
Actionability | Guidance is concrete and specific — 'a branded intersection in TypeScript or a newtype elsewhere', 'Have a parse function at every boundary', 'derive from it instead of hand-rolling a parallel type' — with a concrete UserId/OrderId example and named schema sources (protocol buffer, OpenAPI spec, GraphQL schema). It stops short of showing an actual branded-type example, deferring syntax to the typescript-best-practices skill, which is a minor gap rather than fully executable instruction. | 4 / 5 |
Workflow Clarity | This is a simple single-purpose principle skill where the rubric's simple-skill exception applies: each bullet is unambiguous and carries explicit when-to-apply conditions. No multi-step or destructive/batch operations are involved, so no validation checkpoints are required. | 5 / 5 |
Progressive Disclosure | The skill is under 50 lines with no need for external references (the bundle contains none), and the body is well organized as a heading, a two-sentence framing, and three bold-labeled bullets. Cross-references to sibling skills (typescript-best-practices, boundary-discipline, encode-lessons-in-structure) are clearly signaled and one level deep. | 5 / 5 |
Total | 19 / 20 Passed |