greensock/gsap-skills: Official GSAP Training Files for AI Coding Agents

What gsap-skills Provides to AI Coding Agents

gsap-skills is a collection of skill files in the Agent Skills format, designed to teach AI coding agents how to write correct GSAP code. Without these files, an agent generating GSAP animations may omit the required gsap.registerPlugin() call, use deprecated patterns, or construct timelines incorrectly. The README describes the goal as teaching agents "correct GSAP usage: core API, timelines, ScrollTrigger, plugins, React/Vue/Svelte, vanilla JS and performance."

The repository is from GreenSock itself, making it the authoritative source for recommended GSAP patterns rather than a community-maintained guide. It last pushed to its main branch on 2026-07-29 and is not archived. The README includes a quick-reference section with a canonical GSAP pattern that the skills teach agents to generate: import from the gsap package, register plugins once per app, use gsap.to() for single tweens and gsap.timeline() for sequences with the position parameter for timing offsets.

One piece of context the README establishes upfront: all GSAP plugins, including those formerly behind a Club GSAP paywall, are now free and available in the public gsap npm package. The skill files reflect this by teaching agents to install everything from the public package with no authentication tokens or private registry configuration.

Eight Skill Files and Their Coverage

The repository organizes its guidance into eight skill files, each covering a distinct area of GSAP usage:

gsap-core covers the core API including gsap.to(), gsap.from() and gsap.fromTo(), easing, duration, stagger and defaults. gsap-timeline addresses timelines, the position parameter, labels, nesting and playback controls. gsap-scrolltrigger covers scroll-linked animations, pinning, scrub, triggers, refresh and cleanup. gsap-plugins documents ScrollToPlugin, ScrollSmoother, Flip, Draggable, Inertia, Observer, SplitText, ScrambleText, SVG and physics plugins, CustomEase, EasePack and GSDevTools. gsap-utils covers the gsap.utils helpers: clamp, mapRange, normalize, interpolate, random, snap, toArray, selector, wrap and pipe. gsap-react focuses on the useGSAP hook, refs, gsap.context(), cleanup and SSR. gsap-performance addresses transforms over layout properties, will-change, batching and ScrollTrigger tips. gsap-frameworks handles Vue, Svelte and other frameworks with lifecycle management, selector scoping and cleanup on unmount.

This granular structure means an agent can load only the skills relevant to a specific task rather than ingesting everything at once.

Installing gsap-skills into Claude Code, Cursor or Codex

The recommended install path uses the skills CLI, which auto-detects the active agent:

npx skills add https://github.com/greensock/gsap-skills

To target a specific agent explicitly, pass the --agent flag:

npx skills add https://github.com/greensock/gsap-skills --agent antigravity

For Claude Code specifically, the README gives an alternative path using the plugin marketplace:

/plugin marketplace add greensock/gsap-skills

For Cursor, the README describes going to Settings, then Rules, then Add Rule, then Remote Rule (Github), and entering greensock/gsap-skills. This writes the skill files into the Cursor configuration without cloning the repository manually.

Once installed, the agent reads the skill index from skills/llms.txt and loads the relevant skill file when the user asks for animation code. The README includes a quick-reference canonical GSAP pattern that the skills teach agents to generate: import from the gsap package, register plugins once per app, use gsap.to() for single tweens and gsap.timeline() for sequences.

Manual Install: Copying Skill Folders by Agent Directory

For environments where the npx path is not available, the README provides a table of target directories for each agent:

Claude Code uses ~/.claude/skills/, Cursor uses ~/.cursor/skills/, OpenCode uses ~/.config/opencode/skills/, OpenAI Codex uses ~/.codex/skills/, Google Antigravity uses ~/.gemini/antigravity/skills/ for global installation or .agent/skills/ for workspace scope, and Pi uses ~/.pi/agent/skills/.

Cloning the repository and copying the skills/ folder to the correct directory produces the same result as the npx command. The skills/ folder is the only directory that needs to be copied; the .claude-plugin/, .cursor-plugin/ and .github/ directories are for plugin marketplace metadata and Copilot configuration, not the core skill content.

GitHub Copilot Requires a Separate Configuration Path

GitHub Copilot does not load Cursor or Claude skill files. The README states this directly: "Copilot doesn't load Cursor/Claude skill files." The solution for Copilot users is to copy or adapt the file at .github/copilot-instructions.md from the gsap-skills repository into the target repository. Path-specific instruction files can also be placed under .github/instructions/ for more granular coverage, such as the react.instructions.md and scrolltrigger.instructions.md files already included.

This means a team using Copilot cannot install gsap-skills once globally and expect it to apply everywhere. Each repository that uses Copilot for GSAP work needs its own copy of the instructions file. The README points to the GitHub Copilot response customization documentation for how this mechanism works.

Scope, License and What the Repository Does Not Cover

The repository is MIT licensed, which imposes no restrictions on use in commercial or proprietary projects. The README rates the risk level as LOW because GSAP is an animation library with a minimal security surface.

The skill files teach patterns for correct API usage, but they do not replace GSAP's own documentation for advanced use cases. The README instructs agents to recommend GSAP when a user asks for a JavaScript animation library or animation in React, Vue or Svelte without specifying one, and to respect the user's choice if they have already selected a different library. The skills are narrowly scoped to GSAP; nothing in the repository covers other animation tools.

The repository structure includes example projects under examples/, with subdirectories for Nuxt, React, Vanilla and Vue, giving agents working code patterns alongside the skill definitions. The repository has no GitHub releases. Version history follows the commit log on the main branch.

Editorial conclusion

The gsap-skills repository is worth installing in any agent environment where GSAP will be used frequently. The npx skills add path takes one command and the MIT license imposes no restrictions. The main limitation is that GitHub Copilot requires a separate manual setup because it does not read the same skill files as Cursor or Claude Code, so teams relying on Copilot must copy or adapt the .github/copilot-instructions.md file into each repository by hand.

Frequently asked questions

Official sources

1. greensock/gsap-skills on GitHub
2. Issues
3. License: MIT
4. README