Content
77%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.
The body is a strong, opinionated instruction set with specific timing budgets, a decision tree for pairing elements, explicit verification steps, and a required output format. Its main defect is structural: it repeatedly defers detail to a RECIPES.md that is missing from the bundle, leaving dead-end references.
Suggestions
Add the missing RECIPES.md to the bundle (containing the duplicate-view crossfade technique, duration-scaling/clamp recipes, and per-tool CSS/Motion implementation recipes), or remove the three references and inline the essential recipes.
Trim the "Initial Response" section and rhetorical asides (e.g., the wave/queue framing repeats) to tighten token efficiency.
Include one small complete, copy-paste-ready code example (e.g., a CSS --index stagger or a Motion variants snippet) so the common case is fully executable from SKILL.md alone.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with non-obvious, specific guidance (timing budgets like "30–80ms between items, with the total under ~300ms", a clamp formula, interruption tests) and explains nothing Claude already knows, but the "Initial Response" script and occasional rhetorical flourishes are minor instances of content that could be trimmed, fitting the efficient-with-minor-trims anchor rather than every-token-earns-its-place. | 4 / 5 |
Actionability | Concrete, executable inline guidance appears throughout ("--index custom property per item × a delay variable, on a keyframe with animation-fill-mode: both", "delayChildren: stagger(...)", "pass the direction through custom", "await Promise.all(...)", a useRef gating pattern), which is mostly executable with minor gaps — no complete copy-paste example, and per-tool recipes are deferred to RECIPES.md. | 4 / 5 |
Workflow Clarity | A clear two-level sequence (Steps 1–5, then Workflow 1–6) is paired with explicit validation checkpoints: write the timeline before coding and check it against budgets, record and step through frame by frame, run the interruption checks, and "imagine the 50th use of the day", plus a 3-part required output format — matching the anchor for clear sequence with explicit validation steps and checklists. | 5 / 5 |
Progressive Disclosure | Section structure is good and references are clearly signaled, but the body points to [RECIPES.md](RECIPES.md) three times (duplicate-view technique, duration-scaling recipes, per-tool implementation recipes) and no RECIPES.md exists in the bundle — the referenced content is simply unavailable, which is a real organization gap beyond the minor-gaps level. | 3 / 5 |
Total | 16 / 20 Passed |