Content
96%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: a copy-paste output format, worked examples covering the main query types, explicit disambiguation pairs, and fallback behavior for unmatched effects, all with virtually no wasted tokens. The only structural note is that the large inline glossary keeps progressive disclosure at 'good' rather than 'ideal', though keeping it always-loaded is a reasonable design choice for a lookup skill.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is nearly all payload: six terse instructions, three worked examples, and one-line glossary entries that the skill explicitly instructs to "Quote the glossary verbatim" since "Its descriptions are authoritative" — so even well-known terms earn their tokens as the controlled vocabulary. No padded explanations of concepts Claude already knows, and the anti-drift check against anchor 4 finds no trimmable over-explanation. | 5 / 5 |
Actionability | Fully executable guidance for an instruction-only skill: a copy-paste output template ("**Stagger** — Animate several items one after another with a small delay between each, creating a cascade."), three concrete input→output examples covering feel-based, disambiguation, and physics cases, and named confusable pairs ("Clip-path vs Mask, Pop in vs Bounce, Shared element transition vs Layout animation"). | 5 / 5 |
Workflow Clarity | A clear six-step sequence covering the happy path ("Read for intent, not keywords"), disambiguation, the no-match fallback ("name the closest term and say plainly it's an approximation"), and scope enforcement ("say so rather than inventing one"). This is a single-purpose lookup skill with an unambiguous action, and no destructive or batch operations exist, so no validation cap applies. | 5 / 5 |
Progressive Disclosure | Well-organized sections (Quick Start, Instructions, Examples, ten categorized glossary groups) with clear headers, but the ~120-line glossary is inlined entirely in SKILL.md with no references. Inlining is defensible since every lookup needs the full vocabulary, yet the skill exceeds the under-50-lines simple-skill threshold, matching anchor 4's 'most content is appropriately placed; minor organization gaps' rather than 5's ideal split. | 4 / 5 |
Total | 19 / 20 Passed |