gsap-performance

Optimizes GSAP animations for smooth 60fps rendering using transforms, batching, and layer promotion.

Updated Aug 10, 2026
One-click install
npx skills add https://github.com/KryptaMedina7/quero-s-home --skill gsap-performance-kryptamedina7
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsap-performance
Source: https://github.com/KryptaMedina7/quero-s-home/tree/main/.agents/skills/gsap-performance
Command: npx skills add https://github.com/KryptaMedina7/quero-s-home --skill gsap-performance-kryptamedina7

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? GSAP animations can cause jank, dropped frames, and layout thrashing when they animate layout-heavy properties or create excessive tweens. This Skill provides concrete rules and patterns to keep animations on the compositor thread and maintain smooth 60fps rendering. ## Core Features & Use Cases - Compositor-Friendly Properties: Guides you to animate transform and opacity instead of width, height, top, or left to avoid layout and paint costs. - Efficient Update Patterns: Recommends gsap.quickTo() for frequently updated properties like mouse followers, and stagger instead of many manual tweens. - ScrollTrigger Tuning: Covers pin promotion, scrub values, and debounced ScrollTrigger.refresh() calls to reduce scroll-related work. - Use Case: When a scroll-driven page with dozens of animated elements stutters on low-end devices, apply these rules to replace layout-triggering properties with x/y transforms, batch updates, and kill off-screen animations. ## Quick Start Review my GSAP animation code and optimize it for 60fps performance using transform-based properties and efficient tween patterns.

Frequently Asked Questions about gsap-performance

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

FAQPage Schema
How do I optimize GSAP animations for 60fps performance?

Animate transform properties (x, y, scale, rotation) and opacity, which stay on the compositor and avoid layout. Add will-change: transform in CSS only on elements that actually animate, and use stagger or quickTo instead of creating many individual tweens.

Which CSS properties should I avoid animating with GSAP?

Avoid animating width, height, top, left, margin, and padding because they trigger layout and can cause jank. Use GSAP's x and y (translate transforms) and scale instead to achieve the same visual movement on the compositor.

What is gsap.quickTo and when should I use it?

gsap.quickTo() creates a single reusable tween for properties updated frequently, such as mouse-follower x/y positions. It avoids creating a new tween on every mousemove event, reducing overhead for continuously updated animations.

How do I improve ScrollTrigger performance in GSAP?

Pin only the elements that need it, use a small scrub value like scrub: 1 to reduce scroll work, and call ScrollTrigger.refresh() only when layout actually changes, debounced where possible. Test on low-end devices to verify smoothness.

Why does my GSAP animation jank with many elements?

Jank occurs when hundreds of simultaneous tweens or ScrollTriggers run at once, or when layout-heavy properties are animated. Use stagger for identical animations, virtualize long lists, animate only visible items, and kill off-screen animations.

Should I set will-change or force3D on every animated element?

No. Apply will-change only to elements that are actually animating, since blanket layer promotion wastes memory and can hurt performance. Use it as a targeted hint, not a default for every element.