Content
75%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 well-organized, code-first reference: executable examples cover the common React cases, performance and accessibility guidance is concrete, and structure is clear throughout. The main improvement opportunities are trimming the redundant Best Practices Summary, completing imports in the later snippets, and splitting some full worked examples into reference files to shorten SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean: terse bullets and code with no padding explaining what Lottie is or how libraries work. Minor trims remain — the "You are an expert in..." preamble and the 10-item "Best Practices Summary" that restates every preceding section. Not 5 due to that duplicated summary; not 3 since nearly every other token earns its place. | 4 / 5 |
Actionability | Concrete install commands and copy-paste-ready TSX for the common cases: basic usage, playback control, lazy loading with IntersectionObserver, hover mode, reduced-motion fallback, error fallback, preloader, and cleanup. Minor gaps: later snippets (SegmentAnimation, AnimationWithFallback, ScrollLottie) omit imports and use untyped props, keeping it below the fully-executable anchor 5. | 4 / 5 |
Workflow Clarity | Sections are thematically sequenced (format → install → usage → performance → interactivity → accessibility → loading → size → cleanup) and each topic's guidance is unambiguous, with error handling (onError), reduced-motion checks, and unmount cleanup present as checkpoints. Not 5: no explicit end-to-end implementation sequence with validation steps; not 3: checkpoints are present, not missing or merely implicit. | 4 / 5 |
Progressive Disclosure | Scored against the actual bundle: a single SKILL.md with no reference files, all content inline in one well-sectioned document with clear headers and easy navigation. The ~300 lines are on the long side — full interactivity and accessibility component examples could live in reference files — but placement and structure are good, matching anchor 4 rather than 5 (the under-50-lines simple-skill exception does not apply) or 3 (structure is more than 'some'). | 4 / 5 |
Total | 16 / 20 Passed |