This repository provides official AI skills for the GreenSock Animation Platform (GSAP), designed to teach coding agents how to correctly implement GSAP animations. It targets AI assistants like Claude, Cursor, and Copilot, enabling them to generate more accurate and efficient JavaScript animations, covering core functionalities, advanced plugins, and framework integrations.

How It Works

The project structures GSAP knowledge into distinct "skills" modules (e.g., gsap-core, gsap-scrolltrigger, gsap-react). These modules contain guidance, best practices, and code examples that AI agents can ingest and utilize. This approach standardizes GSAP usage across different AI coding tools, ensuring consistent application of core APIs, timelines, scroll-driven animations, and plugin functionalities.

Quick Start & Requirements

Installation is primarily done via the skills CLI: npx skills add https://github.com/greensock/gsap-skills. Alternatively, the skills/ folder can be cloned and copied into an agent's skill directory, or installed via agent-specific plugin marketplaces (e.g., Claude Code, Cursor). The skills are compatible with Cursor, Claude Code, Codex, Windsurf, Copilot, and over 40 other AI agents.

Highlighted Details

• Comprehensive coverage of GSAP's core API (gsap.to, from, fromTo), timelines, and advanced features like ScrollTrigger.
• Detailed skills for numerous GSAP plugins, including ScrollToPlugin, Flip, Draggable, and SVG/physics plugins.
• Framework-specific guidance for React (including the useGSAP hook and gsap.context), Vue, and Svelte.
• Includes skills focused on performance optimization and utility functions (gsap.utils).

Maintenance & Community

The project is officially maintained by GreenSock and designed for broad compatibility with numerous AI coding agents. Specific community links (like Discord/Slack) or contributor details are not provided in the README.

Licensing & Compatibility

The repository is licensed under the MIT license, which is permissive for commercial use and integration into closed-source projects.

Limitations & Caveats

GitHub Copilot does not directly load Cursor or Claude skill files; users must adapt .github/copilot-instructions.md for Copilot integration. The skills are intended for AI agents rather than direct end-user consumption as a library.