Content
67%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 dense, well-structured reference with strong executable examples and clearly signaled external doc links. Its main weaknesses are notable redundancy between the best-practices and Do-Not sections and a monolithic single-file layout for a reference of this length.
Suggestions
Collapse the 'Official GSAP best practices' and 'Do Not' sections into a single list; the negative restatement (and intra-section repeats like the two refresh items) wastes tokens.
Move the exhaustive config table and the batch()/scrollerProxy() API details into a local REFERENCE.md, keeping SKILL.md as a concise overview with one-level-deep links.
Fix the `Max.max` typo (should be `Math.max`) in the horizontal-scroll example so the code is copy-paste executable.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient curated API reference, but the 'Official GSAP best practices' and 'Do Not' sections substantially duplicate each other (refresh-after-layout, registerPlugin, ease:'none', refreshPriority, markers-in-production all appear in both), and some Do-Not items repeat one another. | 3 / 5 |
Actionability | Provides numerous concrete, executable JavaScript examples (registerPlugin, basic trigger, batch, scrollerProxy, scrub, pinning, timeline, horizontal scroll, cleanup) plus a typed config table, with only minor gaps such as the `Max.max` typo in the horizontal-scroll example. | 4 / 5 |
Workflow Clarity | The horizontal-scroll section is a clearly numbered 4-step sequence and critical checkpoints (ease:'none', refreshPriority ordering, refresh after layout changes, kill on cleanup) are emphasized throughout, though a few verification steps are implicit rather than explicit. | 4 / 5 |
Progressive Disclosure | Well-organized into clear sections with one-level-deep references signaled to the official GSAP docs, but the ~290-line single file inlines substantial reference material (full config table, batch, scrollerProxy) that could be split into local reference files. | 4 / 5 |
Total | 15 / 20 Passed |