Deepseek ArtifactsDeepseek Artifacts

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-skills

Target a specific agent with --agent, for example npx skills add https://github.com/greensock/gsap-skills --agent antigravity. Other documented routes:

AgentHow (README)
Claude Code/plugin marketplace add greensock/gsap-skills
CursorSettings → Rules → Add Rule → Remote Rule (GitHub) → greensock/gsap-skills
Manual copyCopy 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.

SkillScope
gsap-coreCore API: gsap.to() / from() / fromTo(), easing, duration, stagger and defaults.
gsap-timelineSequencing, the position parameter, labels, nesting and playback control.
gsap-scrolltriggerScroll-linked animation: pinning, scrub, triggers, refresh and cleanup.
gsap-pluginsScrollToPlugin, ScrollSmoother, Flip, Draggable, Inertia, Observer, SplitText, ScrambleText, SVG and physics plugins, CustomEase, EasePack, GSDevTools.
gsap-utilsgsap.utils: clamp, mapRange, normalize, interpolate, random, snap, toArray, selector, wrap, pipe.
gsap-reactThe useGSAP hook, refs, gsap.context(), cleanup and SSR.
gsap-performanceTransforms over layout properties, will-change, batching, ScrollTrigger tips.
gsap-frameworksVue 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

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.