gsap-performance

Optimize GSAP animations to reduce layout thrashing and maintain 60fps.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/eryckassis/Dior-Luxury-Boutique-Saas --skill gsap-performance-eryckassis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsap-performance
Source: https://github.com/eryckassis/Dior-Luxury-Boutique-Saas/tree/main/.agents/skills/gsap-performance
Command: npx skills add https://github.com/eryckassis/Dior-Luxury-Boutique-Saas --skill gsap-performance-eryckassis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

GSAP performance optimization to reduce jank and keep animations smooth at 60fps by prioritizing compositing-friendly properties.

Core Features & Use Cases

  • Transform-focused animation guidance: use translate/transform and opacity for most motion to keep work on the compositor.
  • Best practices: batched reads/writes, use will-change on elements that animate, reuse timelines for efficiency, and limit layout thrashing.
  • Use Case: when you have scroll-triggered animations or complex timelines, apply these rules to improve frame rate and perceived performance.

Quick Start

Refactor the current GSAP animation to use transforms and opacity for movement and apply will-change to select elements.

Frequently Asked Questions about gsap-performance

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix GSAP animation jank and maintain 60fps?

To fix GSAP animation jank and maintain 60fps, prioritize compositing-friendly properties like transforms and opacity. Batching DOM reads and writes while reusing timelines minimizes layout thrashing and reduces expensive repaints during complex web animations.

How do I optimize ScrollTrigger animations for better web performance?

Optimize ScrollTrigger animations by enforcing transform-focused properties such as x, y, scale, and rotation. Applying will-change to animated elements shifts rendering work to the compositor, significantly improving scroll-triggered frame rates and reducing visual stuttering.

Why does GSAP layout thrashing cause UI stuttering?

GSAP layout thrashing causes UI stuttering when the browser rapidly alternates between reading layout properties and writing styles. This forces synchronous recalculation of the render tree, dropping the frame rate below 60fps and making complex timelines visibly janky.

What are the best practices for GSAP transforms and will-change?

Best practices for GSAP transforms include using x, y, scale, and rotation instead of layout-inducing properties like top or left. Apply will-change only to elements that animate to hint the browser to prepare layers, and reuse timelines to maximize compositor efficiency.

Can I use this GSAP optimization approach for complex timelines?

Yes, this optimization approach works for complex timelines by enforcing batched DOM reads and writes. Reusing timelines instead of creating new instances minimizes memory allocation and repaints, keeping dynamic motion and extensive animation sequences smooth at 60fps.

When should I not use will-change for web animations?

You should not overuse will-change for web animations. Applying it to too many elements increases memory consumption and can degrade performance, so it should only be applied selectively to elements that actively animate using transform and opacity properties.