Content
85%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.
A tight, well-sequenced, highly actionable skill body: concrete value ranges, named APIs, accessibility handling, and an explicit verification checklist. The main defect is that all three files the body points to (demo/index.html, demo/PROMPT.md, REFERENCES.md) are missing from the bundle, and the JS snippet is a fragment rather than runnable code.
Suggestions
Add the referenced files to the bundle (demo/index.html, demo/PROMPT.md, REFERENCES.md) or remove/replace the dangling links — every referenced path currently 404s within the skill directory.
Make the scroll-mapping snippet self-contained (show how `progress` is derived from scroll position and how spans are indexed) so it is copy-paste executable rather than a fragment.
Consider moving the parameter-value ranges (opacity, blur, offset, span, overlap) into a single labeled block or reference file so the working SKILL.md stays a pure overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and imperative throughout — e.g., "Walk text nodes with TreeWalker; do not flatten the container with textContent or innerHTML" — with no explanations of concepts Claude already knows; both snippets are minimal and earn their place. This matches anchor 5's 'every token earns its place'. | 5 / 5 |
Actionability | Concrete guidance dominates: specific defaults ("Hidden opacity: 0.12–0.3", "Blur: 4–10px"), real APIs (TreeWalker, GSAP ScrollTrigger with scrub, prefers-reduced-motion), and a preferred HTML structure. However, the JS snippet references undefined `progress`, `wordCount`, `index`, and `word` — it is a fragment rather than copy-paste executable — placing it at anchor 4 rather than 5. | 4 / 5 |
Workflow Clarity | The sections form a coherent build sequence (Prepare the text → Map scroll to words → Set useful defaults → Preserve emphasis → Keep it readable → Clean up → Verify) and the Verify section is an explicit validation checklist ("inline links and emphasis, punctuation, repeated spaces, 200% zoom, 390/768/1440 widths... reduced motion, keyboard focus, screen-reader reading order, and teardown"). This is a non-destructive skill, so no feedback-loop cap applies, and it matches anchor 5's checklist criterion. | 5 / 5 |
Progressive Disclosure | The body's references are clearly signaled and one level deep ("Use [demo/index.html](demo/index.html) as the working reference and [demo/PROMPT.md](demo/PROMPT.md)... Keep [REFERENCES.md](REFERENCES.md) as the links-only implementation source list"), but none of these files exist in the bundle — following any of them fails. Section organization is good, yet the dangling references leave navigation broken, which fits anchor 3 (structure present, references problematic) better than anchor 4's 'references mostly clear'. | 3 / 5 |
Total | 17 / 20 Passed |