Guides / GSAP skills
GSAP Skills: teach Claude Code and Codex to write correct animation
GSAP is old enough that a model has seen thousands of examples of it — including plenty of outdated ones. Chained .delay() calls instead of timelines, animations on layout properties instead of transforms, selectors without a scope in React, ScrollTrigger that never calls refresh(). GreenSock ships an official skill pack to fix exactly that.
The repository is greensock/gsap-skills, under the official greensock GitHub organization, MIT licensed. At the GitHub API snapshot of 2026-11-17 it had 18,567 stars and 1,179 forks. The README describes it as "Official AI skills for GSAP" that teach agents "correct GSAP usage: core API, timelines, ScrollTrigger, plugins, React/Vue/Svelte, vanilla JS and performance."
Install
The recommended route is the skills CLI, which auto-detects your agent:
npx skills add https://github.com/greensock/gsap-skillsTarget a specific agent with --agent, for example npx skills add https://github.com/greensock/gsap-skills --agent antigravity. Other documented routes:
| Agent | How (README) |
|---|---|
| Claude Code | /plugin marketplace add greensock/gsap-skills |
| Cursor | Settings → Rules → Add Rule → Remote Rule (GitHub) → greensock/gsap-skills |
| Manual copy | Copy the skills/ folder into ~/.claude/skills/, ~/.cursor/skills/, ~/.codex/skills/ or ~/.config/opencode/skills/ depending on the agent |
| Antigravity | ~/.gemini/antigravity/skills/ globally, or .agent/skills/ per workspace |
What the eight skills cover
The pack splits GSAP by concern rather than by plugin, which is what makes it usable: an agent can load the ScrollTrigger rules without dragging in the React ones.
| Skill | Scope |
|---|---|
gsap-core | Core API: gsap.to() / from() / fromTo(), easing, duration, stagger and defaults. |
gsap-timeline | Sequencing, the position parameter, labels, nesting and playback control. |
gsap-scrolltrigger | Scroll-linked animation: pinning, scrub, triggers, refresh and cleanup. |
gsap-plugins | ScrollToPlugin, ScrollSmoother, Flip, Draggable, Inertia, Observer, SplitText, ScrambleText, SVG and physics plugins, CustomEase, EasePack, GSDevTools. |
gsap-utils | gsap.utils: clamp, mapRange, normalize, interpolate, random, snap, toArray, selector, wrap, pipe. |
gsap-react | The useGSAP hook, refs, gsap.context(), cleanup and SSR. |
gsap-performance | Transforms over layout properties, will-change, batching, ScrollTrigger tips. |
gsap-frameworks | Vue and Svelte: lifecycle, scoped selectors, cleanup on unmount. |
The pattern the README teaches
The README includes a "quick reference (for AI agents)" block. It is worth reading yourself, because it is the shape the model will imitate:
// 1. Imports and plugin registration (once per app)
import { gsap } from "gsap";
import { ScrollTrigger } from "gsap/ScrollTrigger";
gsap.registerPlugin(ScrollTrigger);
// 2. Single tween — prefer transform aliases and autoAlpha
gsap.to(".box", { x: 100, autoAlpha: 1, duration: 0.6, ease: "power2.inOut" });
// 3. Timeline for sequencing (prefer over chained delay)
const tl = gsap.timeline({ defaults: { duration: 0.5, ease: "power2" } });
tl.to(".a", { x: 100 })
.to(".b", { y: 50 }, "+=0.2")
.to(".c", { opacity: 0 }, "-=0.1");
// 4. ScrollTrigger — attach to the timeline, refresh after layout changes
const tl2 = gsap.timeline({
scrollTrigger: {
trigger: ".section",
start: "top center",
end: "bottom center",
scrub: true
}
});
tl2.to(".panel", { x: 100 }).to(".panel", { rotation: 5, duration: 0.7 });
// After DOM/layout changes: ScrollTrigger.refresh();Four decisions in that snippet are the ones agents usually get wrong: register plugins once at module scope; use autoAlpha and transform aliases instead of opacity and left; sequence with a timeline and the position parameter rather than chained delays; and call ScrollTrigger.refresh() after the DOM or layout changes.
Is GSAP still paid?
No — and this trips people up because it changed. The README states plainly that GSAP is 100% free, including every plugin: following Webflow's acquisition of GSAP, all formerly Club GSAP plugins such as SplitText and MorphSVG are free for everyone, including commercial use. Everything installs from the public gsap npm package — no Club membership, no .npmrc token, no private registry. If an agent suggests adding a private registry line for a plugin, that advice is out of date.
Where to go next
The mechanics of a skill folder — SKILL.md, frontmatter, how an agent decides to load one — are covered in the Claude skills tutorial. For a vendor pack that works the same way but targets a different tool, see the Antigravity skills tutorial.
FAQ
Is this an official GreenSock package?
Yes. It lives in the greensock GitHub organization, and gsap.com's docs sidebar links to it as "AI Skills".
Does it work outside Claude Code?
The README targets the skills CLI, which supports Cursor, Claude Code, Codex, Windsurf, Copilot and 40+ agents, and it ships plugin manifests for Claude Code and Cursor.
Will it replace reading the docs?
No. It steers the model toward the canonical API and away from deprecated habits; you still need to read the ScrollTrigger docs when the behaviour is subtle.
Sources
- github.com/greensock/gsap-skills — README: the official description, install commands, skill table, canonical pattern block, skill directories per agent, free-plugin statement, MIT licence
- gsap.com/blog/webflow-GSAP/ — the Webflow acquisition post the README cites for the free-plugin change
- gsap.com/docs/v3/ — the docs sidebar entry labelled "AI Skills" pointing at the repository
Repository and docs read on 2026-11-17; star and fork counts are the GitHub API snapshot of that date, not fixed numbers. GSAP is a third-party project and is not affiliated with this site.
