GSAP Performance

Inspect layout, paint and resource costs, using measured evidence to address animation jank.

Motion & interactiongreensock/gsap-skillsMITSources checked: 2026-10-21

See installation steps View original Skill

Features

Prefer transforms, avoid repeated layout reads and writes, and limit will-change usage.
Use performance recordings on real devices to assess trigger counts and animation costs.

When to use it

Useful for long animated lists, scroll jank and interaction tuning on lower-powered devices.

Before you start

Requires a working frontend project and GSAP. Installing this Skill does not add animation dependencies to your app; the GSAP runtime and plugins have their own license.

Usage example

Follow this illustrative workflow, replacing file names and goals with your own project details.

Investigate scrolling jank on a long page

What to prepare: A page with reproducible jank, device details and a performance recording.
Workflow: Identify expensive layout and duplicate triggers, make focused fixes and record again under the same conditions.
Expected deliverables: Measured comparisons, focused fixes and a clear list of untested devices.

Recommended prompts

Replace the bracketed placeholders, then paste into an AI tool with this skill installed. Prompts follow the interface language; copying preserves the full text and line breaks.

Use the gsap-performance Skill for the scrolling page in [project path]. Read the existing components and interaction constraints, then make the smallest necessary changes while preserving content and keyboard behavior. Check layout thrashing, duplicate triggers, long tasks and real-device behavior and provide a usable reduced-motion fallback. Report only checks actually run; do not claim unmeasured performance improvements.

Review the scrolling page just implemented, focusing on layout thrashing, duplicate triggers, long tasks and real-device behavior. Confirm that content remains readable and usable without motion, repeated navigation does not accumulate animations or listeners, and list fixes plus environments not yet verified.

Supported AI tools

Claude CodeTerminal in your project folder
CodexTerminal in your project folder
CursorTerminal in your project folder
Gemini CLITerminal in your project folder
OpenCodeTerminal in your project folder

These tools appear in the Skills CLI support list. Task results depend on the model, project and required runtime.

Installation

Requires Node.js 22.20 or later. The command selects this skill; follow the installer to confirm its location in the project.

Choose an AI tool

Run in: Terminal in your project folder

Install into the selected tool with Skills CLI. The original project also documents other installation methods.

npx skills add greensock/gsap-skills --skill gsap-performance -a claude-code

Restart the tool or open a new session, then mention this skill when describing your task.

Check the official setup guide

Source and license

This guide summarizes the original skill definition, README and setup documentation. Models, accounts and external services are provided by their respective tools.

SKILL.md README License terms

The MIT license for GSAP Skills is separate from the GSAP runtime license. Review the GSAP Standard License before using its runtime or plugins. GSAP runtime license