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 skill body: runnable code, precise gotchas that go beyond common knowledge, a clear decision rule for choosing the animation layer, and a properly disclosed one-level reference file. The only blemish is a slightly flavored opening sentence that assumes less competence than the rest of the file.
Suggestions
Tighten the opening paragraph to a single functional sentence (e.g. "Pick the right animation layer; the gotchas below bite hardest.") to free tokens for content Claude does not know.
Drop or compress "Every SVG element is a DOM node you can style, animate, and script" — it is background knowledge Claude already has.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean — compact code blocks and one-line gotchas — but the opening paragraph ("Handcrafted SVG animation. Every SVG element is a DOM node you can style, animate, and script; the craft is picking the right animation layer...") re-states basics Claude already knows and adds flavor that could be trimmed. | 4 / 5 |
Actionability | Fully executable guidance: copy-paste-ready SVG/CSS blocks for stroke drawing and SMIL chaining, exact syntax ("begin=\"first.end\"", "calcMode=\"spline\" with 0.42 0 0.58 1"), and concrete commands like "path.getTotalLength()" covering the common cases. | 5 / 5 |
Workflow Clarity | As a simple, non-destructive skill, the single core decision is unambiguous: "Prefer SMIL for self-contained assets (icons, logos); use CSS keyframes when the SVG is inlined and the animation should coordinate with the rest of the page", with explicit criteria for the choice. | 5 / 5 |
Progressive Disclosure | "Read [references/recipes.md](references/recipes.md) when you need a ready-made pattern: loading spinner, animated checkmark, hamburger-to-X morph, motion along a path..." is a well-signaled, one-level-deep reference with enumerated contents; the file exists and its recipes match the listing, while the gotchas and core techniques are appropriately inlined. | 5 / 5 |
Total | 19 / 20 Passed |