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.
The body is a tight, scenario-organized set of performance directives with executable snippets for quickTo and will-change, and it appropriately lives in a single file with no external references. Its main flaw is redundancy: the closing 'Best practices' and 'Do Not' sections restate earlier sections almost word-for-word, and the central transform guidance lacks a code example.
Suggestions
Merge the 'Best practices' and 'Do Not' recap sections into the topic sections they duplicate — every bullet in them restates guidance already given verbatim in 'Prefer Transform and Opacity', 'Many Elements', and 'ScrollTrigger and Performance'.
Add a minimal executable transform example alongside the quickTo one (e.g. gsap.to('.el', { x: 100, duration: 0.3 })) so the skill's core recommendation has copy-paste code too.
Consider a brief diagnostic ordering at the top (identify the jank source — layout, paint, or too many active tweens — then apply the matching section) to give the scenario sections a clear sequence.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The topic sections are lean and imperative with no concept-explanation padding, but the 'Best practices' and 'Do Not' sections recap earlier sections nearly verbatim (~15 of 75 lines of pure duplication: 'Animate transform and opacity; use will-change...', 'Use stagger instead of many separate tweens...', 'Animate width/height/top/left...'), which could be trimmed. | 3 / 5 |
Actionability | Concrete ✅/❌ property lists, copy-paste-ready quickTo and will-change: transform snippets, and specific API calls (stagger, scrub: 1, ScrollTrigger.refresh(), pin: true). Minor gaps: the core transform recommendation and stagger have guidance but no executable code example, unlike quickTo. | 4 / 5 |
Workflow Clarity | This is a guidance/reference skill rather than a multi-step process, and each section is unambiguously organized by scenario (movement, mouse followers, lists, scroll) with clear do/don't directives and no risky operations needing validation. It falls short of 5 because there is no diagnostic ordering (e.g., identify the jank source first, then apply the matching fix). | 4 / 5 |
Progressive Disclosure | A well-sectioned single-file body with no external file references — and none are needed at this size (the sibling-skill mentions gsap-core/gsap-timeline/gsap-scrolltrigger are cross-skill pointers, not broken paths). The duplicated recap sections are the only organization gap keeping it below 5. | 4 / 5 |
Total | 15 / 20 Passed |