gsap-performance

Optimize GSAP animations with transform-based motion and cleanup for reduced jank.

Updated Jun 4, 2026
One-click install
npx skills add https://github.com/Carlosfwd86/Conectando-Talento-UCR --skill gsap-performance-carlosfwd86
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsap-performance
Source: https://github.com/Carlosfwd86/Conectando-Talento-UCR/tree/main/Skill%20GSAP/gsap-skills/skills/gsap-performance
Command: npx skills add https://github.com/Carlosfwd86/Conectando-Talento-UCR --skill gsap-performance-carlosfwd86

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you eliminate jank and reduce animation cost in GSAP projects by choosing properties and patterns that keep motion smooth and responsive.

Core Features & Use Cases

  • Transform-first animation: Prefer x, y, scale, rotation, and opacity to avoid layout and heavy paint work.
  • Performance guardrails: Use will-change sparingly, batch reads and writes, and avoid layout thrashing when mixing GSAP with DOM logic.
  • High-frequency interactions: Use stagger, quickTo, and timeline reuse for mouse followers, lists, and other rapidly updated effects.
  • Scroll performance: Tune ScrollTrigger pinning, scrub behavior, and refresh timing to keep scrolling fluid.
  • Use case: Optimize a hero section, interactive gallery, or scroll-driven landing page so it stays close to 60fps on lower-end devices.

Quick Start

Use the gsap-performance skill to review the animation and convert any layout-heavy motion into transform and opacity based updates.

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 on scroll-driven landing pages?

GSAP animation jank is reduced by converting layout-heavy motion into transform and opacity based updates, tuning ScrollTrigger scrub behavior, and batching DOM reads and writes to eliminate layout thrashing during scroll-driven playback.

Why does my GSAP tween cause layout thrashing when mixing with DOM logic?

GSAP tweens cause layout thrashing when DOM reads and writes are not batched, forcing the browser to recalculate styles repeatedly. You must batch DOM work and prefer transform-first animation properties like x, y, and scale to avoid heavy paint work.

What is the best way to optimize GSAP mouse follower interactions for high refresh rates?

The best way to optimize high-frequency GSAP interactions like mouse followers is using quickTo updates, stagger, and timeline reuse. These patterns rapidly update transforms without allocating new tween instances, maintaining smooth playback on high-refresh devices.

Can I use will-change to improve GSAP transform and opacity animations?

You can use will-change to improve GSAP transform and opacity animations, but it must be applied sparingly. Overusing will-change hints consumes excessive memory, so apply them only to elements actively undergoing motion to reduce paint cost without degrading overall page performance.

Does GSAP ScrollTrigger need specific tuning for smooth pinning and scrub behavior?

GSAP ScrollTrigger needs specific tuning for smooth pinning and scrub behavior, including adjusting refresh timing and scrub sensitivity. Properly tuned ScrollTrigger effects prevent scroll jank and keep motion fluid during scroll-driven animations on both low-end and high-refresh devices.

When should I not use GSAP layout properties for motion-heavy interfaces?

You should not use GSAP layout properties like width, height, or top for motion-heavy interfaces because they trigger heavy paint and layout work. Instead, use transform-based motion with x, y, scale, and rotation to keep playback smooth and reduce animation cost.