GreenSock's official skill for GSAP timelines: gsap.timeline(), the position parameter, labels, defaults, nesting and playback control, plus the best practices and mistakes to avoid when sequencing animations.
GSAP Performance Skill
GreenSock's official skill for smooth GSAP animation: animate transforms and opacity, avoid layout thrashing, use stagger and quickTo(), and keep ScrollTrigger work cheap.
Install
Other ways to install
About
- Prefer transform and opacity over layout-triggering properties
- Targeted will-change and force3D use
- Batch DOM reads and writes to avoid layout thrashing
- stagger and gsap.quickTo() for many elements and frequent updates
- ScrollTrigger pin, scrub and refresh() guidance
- Explicit do and do-not checklists
GSAP Performance is one of GreenSock's official agent skills for the GSAP animation library, alongside the core, timeline, ScrollTrigger and React skills. It applies when an agent is optimising GSAP animations for a steady 60fps, reducing jank, or answering questions about animation performance.
Its guidance is specific. Animate transform properties (x, y, scale, rotation, skew) and opacity, which stay on the compositor, instead of width, height, top, left, margin or padding, which trigger layout. Use will-change only on elements that actually animate. Keep DOM reads and writes batched rather than interleaved. Use stagger instead of many separate tweens with manual delays, and virtualise or limit very long animated lists. For values updated on every pointer move, such as mouse followers, use gsap.quickTo(), which reuses one tween.
For ScrollTrigger it advises pinning only what is needed, using a small scrub value, and calling ScrollTrigger.refresh() only when layout really changes, debounced. It also asks the agent to pause or kill off-screen animations and clean up stray tweens and triggers. The skill ends with explicit do and do-not lists. MIT licensed.
SKILL.md
The instructions your agent loads, as published by GreenSock.
Related Skills
See all GSAP Performance alternativesSkill: GSAP Core
by GreenSock
GreenSock's official skill for the GSAP core engine — tweens, eases, staggers, defaults and responsive/reduced-motion animation via matchMedia.
GreenSock's official ScrollTrigger skill — scroll-linked animation, pinning, scrub and trigger positioning, with the exact start/end syntax agents get wrong.
GreenSock's official skill for using GSAP in React and Next.js: the useGSAP() hook with scoped selectors and automatic cleanup, refs for targets, contextSafe callbacks, gsap.context() in useEffect, and SSR-safe usage.