gsap-performance

Optimize GSAP animations with transforms and compositor-friendly practices.

Updated Mar 27, 2026
One-click install
npx skills add https://github.com/AlejandroFigini/artist-portfolio --skill gsap-performance-alejandrofigini
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsap-performance
Source: https://github.com/AlejandroFigini/artist-portfolio/tree/main/.agent/skills/gsap-performance
Command: npx skills add https://github.com/AlejandroFigini/artist-portfolio --skill gsap-performance-alejandrofigini

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

GSAP performance bottlenecks can cause jank and frame drops; this skill provides a set of guidelines to keep animations fluid and efficient.

Core Features & Use Cases

  • Prefer transforms and opacity to keep work on the compositor and avoid layout thrash.
  • Batch reads and writes to minimize layout recalculations for large animation sets.
  • Apply will-change judiciously and leverage ScrollTrigger best practices to improve scroll-based performance.
  • Coordinate timelines and use core GSAP features to maintain stability under load.

Quick Start

Swap movement from left/top to x/y transforms on the main animated elements to immediately improve frame rate.

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 frame drops?

GSAP animation jank is fixed by avoiding layout thrashing and maximizing compositor work. Animate transforms and opacity instead of layout-driven properties like left or top to sustain smooth 60fps.

What is the best way to optimize ScrollTrigger performance for web animations?

ScrollTrigger performance is optimized by applying will-change judiciously and batching reads and writes. This minimizes layout recalculations for large animation sets and improves scroll-based frame rates across devices.

How do I batch GSAP reads and writes to minimize layout recalculations?

Batch GSAP reads and writes by grouping DOM read operations separately from write operations to prevent forced synchronous layout recalculations. This maintains high-performance rendering for large animation sets.

Can I use x and y transforms instead of left and top for smoother GSAP animations?

Yes, you can swap movement from left and top to x and y transforms on animated elements. This keeps animation work on the compositor thread, avoiding layout thrash and immediately improving frame rate.

When should I use will-change with GSAP animations?

Use will-change judiciously with GSAP animations to hint the browser about upcoming transform or opacity changes. Apply it strategically to sustain smooth 60fps without overloading compositor memory.

Why does coordinating GSAP timelines improve animation stability under load?

Coordinating GSAP timelines improves stability under load by synchronizing multiple animation sequences efficiently. Using core GSAP features and timelines prevents overlapping layout-driven calculations and maintains fluid rendering.