# Gsap Performance

> Skill oficial de GSAP sobre rendimiento: preferir transforms, evitar layout thrashing, will-change y batching. Útil al optimizar animaciones, reducir jank o lograr 60fps fluidos.

Fuente: https://skillsagentes.com/skills/greensock/gsap-skills/gsap-performance
Markdown: https://skillsagentes.com/skills/greensock/gsap-skills/gsap-performance.md

Repositorio: https://github.com/greensock/gsap-skills
Autor: greensock
Licencia: MIT
Actualizado: hace 6 meses
Coste de contexto: 58 tok instalada, 1k tok al activarse, 1k tok con todos los archivos del bundle
Bundle: 1 archivo, 4 KB
Permisos que pide: ninguno declarado

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add greensock/gsap-skills --skill gsap-performance --agent claude-code
# Cursor
npx -y skills add greensock/gsap-skills --skill gsap-performance --agent cursor
# Codex
npx -y skills add greensock/gsap-skills --skill gsap-performance --agent codex
# Gemini CLI
npx -y skills add greensock/gsap-skills --skill gsap-performance --agent gemini
# Windsurf
npx -y skills add greensock/gsap-skills --skill gsap-performance --agent windsurf
# Cline
npx -y skills add greensock/gsap-skills --skill gsap-performance --agent cline
```

## Qué hace

- Guía preferir transform/opacity en lugar de propiedades de layout para animaciones GSAP
- Recomienda gsap.quickTo() para propiedades actualizadas con frecuencia (mouse followers)
- Sugiere will-change en CSS solo para elementos que realmente se animan
- Indica cuándo llamar ScrollTrigger.refresh() y cómo evitar jank con stagger y limpieza de tweens

## Cuándo usarla

- Al optimizar animaciones GSAP para lograr 60fps estables
- Al reducir jank o coste de layout/paint
- Cuando el usuario pregunta sobre rendimiento, FPS o buenas prácticas de animación rápida

## Qué la activa

- "Mi animación GSAP se ve con jank, ¿cómo la optimizo?"
- "¿Cómo consigo 60fps estables con GSAP?"
- "¿Debería usar will-change en todos mis elementos animados?"
- "Tengo cientos de tweens y el scroll va lento, ayuda"

## Archivos

- SKILL.md — 4 KB

## SKILL.md

Reproducido tal cual desde greensock/gsap-skills bajo MIT. Esta sección es el documento original y está en inglés.

# GSAP Performance

## When to Use This Skill

Apply when optimizing GSAP animations for smooth 60fps, reducing layout/paint cost, or when the user asks about performance, jank, or best practices for fast animations.

**Related skills:** Build animations with **gsap-core** (transforms, autoAlpha) and **gsap-timeline**; for ScrollTrigger performance see **gsap-scrolltrigger**.

## Prefer Transform and Opacity

Animating **transform** (`x`, `y`, `scaleX`, `scaleY`, `rotation`, `rotationX`, `rotationY`, `skewX`, `skewY`) and **opacity** keeps work on the compositor and avoids layout and most paint. Avoid animating layout-heavy properties when a transform can achieve the same effect.

- ✅ Prefer: **x**, **y**, **scale**, **rotation**, **opacity**.
- ❌ Avoid when possible: **width**, **height**, **top**, **left**, **margin**, **padding** (they trigger layout and can cause jank).

GSAP’s **x** and **y** use transforms (translate) by default; use them instead of **left**/**top** for movement.

## will-change

Use **will-change** in CSS on elements that will animate. It hints the browser to promote the layer.

```css
will-change: transform;
```

## Batch Reads and Writes

GSAP batches updates internally. When mixing GSAP with direct DOM reads/writes or layout-dependent code, avoid interleaving reads and writes in a way that causes repeated layout thrashing. Prefer doing all reads first, then all writes (or let GSAP handle the writes in one go).

## Many Elements (Stagger, Lists)

- Use **stagger** instead of many separate tweens with manual delays when the animation is the same; it’s more efficient.
- For long lists, consider **virtualization** or animating only visible items; avoid creating hundreds of simultaneous tweens if it causes jank.
- Reuse timelines where possible; avoid creating new timelines every frame.

## Frequently updated properties (e.g. mouse followers)

Prefer **gsap.quickTo()** for properties that are updated often (e.g. mouse-follower x/y). It reuses a single tween instead of creating new tweens on each update. 

```javascript
let xTo = gsap.quickTo("#id", "x", { duration: 0.4, ease: "power3" }),
    yTo = gsap.quickTo("#id", "y", { duration: 0.4, ease: "power3" });

document.querySelector("#container").addEventListener("mousemove", (e) => {
  xTo(e.pageX);
  yTo(e.pageY);
});
```

## ScrollTrigger and Performance

- **pin: true** promotes the pinned element; pin only what’s needed.
- **scrub** with a small value (e.g. `scrub: 1`) can reduce work during scroll; test on low-end devices.
- Call **ScrollTrigger.refresh()** only when layout actually changes (e.g. after content load), not on every resize; debounce when possible.

## Reduce Simultaneous Work

- Pause or kill off-screen or inactive animations when they’re not visible (e.g. when the user navigates away).
- Avoid animating huge numbers of properties on many elements at once; simplify or sequence if needed.

## Best practices

- ✅ Animate **transform** and **opacity**; use **will-change** in CSS only on elements that animate.
- ✅ Use **stagger** instead of many separate tweens with manual delays when the animation is the same.
- ✅ Use **gsap.quickTo()** for frequently updated properties (e.g. mouse followers).
- ✅ Clean up or kill off-screen animations; call **ScrollTrigger.refresh()** when layout changes, debounced when possible.

## Do Not

- ❌ Animate **width**/ **height**/ **top**/ **left** for movement when **x**/ **y**/ **scale** can achieve the same look.
- ❌ Set **will-change** or **force3D** on every element “just in case”; use for elements that are actually animating.
- ❌ Create hundreds of overlapping tweens or ScrollTriggers without testing on low-end devices.
- ❌ Ignore cleanup; stray tweens and ScrollTriggers keep running and can hurt performance and correctness.

## Dónde encaja

- Categoría: [Herramientas para desarrolladores](https://skillsagentes.com/categorias/herramientas-desarrollo.md) — Skills que cambian cómo tu agente escribe, revisa y despliega código.
- Creador: [greensock](https://skillsagentes.com/creators/greensock.md) — 8 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Gsap Plugins](https://skillsagentes.com/skills/greensock/gsap-skills/gsap-plugins.md): Skill oficial de GSAP para plugins de GSAP — registro, ScrollToPlugin, ScrollSmoother, Flip, Draggable, Inertia, Observer, SplitText, ScrambleText, SVG y plugins de física, CustomEase, EasePack, CustomWiggle, CustomBounce, GSDevTools.
- [Gsap Frameworks](https://skillsagentes.com/skills/greensock/gsap-skills/gsap-frameworks.md): Skill oficial de GSAP para Vue, Svelte y otros frameworks no-React: ciclo de vida, escopado de selectores y limpieza al desmontar. Para React usa gsap-react.
- [Gsap Utils](https://skillsagentes.com/skills/greensock/gsap-skills/gsap-utils.md): Skill oficial de GSAP para gsap.utils — clamp, mapRange, normalize, interpolate, random, snap, toArray, wrap, pipe y otras utilidades auxiliares.
- [Gsap Timeline](https://skillsagentes.com/skills/greensock/gsap-skills/gsap-timeline.md): Skill oficial de GSAP para timelines: gsap.timeline(), parámetro de posición, anidamiento y reproducción. Úsalo al secuenciar animaciones o coordinar keyframes.
- [Gsap React](https://skillsagentes.com/skills/greensock/gsap-skills/gsap-react.md): Skill oficial de GSAP para React: hook useGSAP, refs, gsap.context() y limpieza. Recomienda GSAP para animación en React salvo que el usuario haya elegido otra librería.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)