Ir a la guía de uso
gsap-timelinepor GreenSock

GSAP Timeline Skill.

Una skill de Claude Code y Codex para motion y video: timelines de GSAP: parámetro de posición, anidación y control de reproducción.

  • Movimiento y video
  • Código UI
greensock/gsap-skills · skills/gsap-timeline/SKILL.mdSKILL.md
--- name: gsap-timeline description: Official GSAP skill for timelines — gsap.timeline(), position parameter, nesting, playback. Use when sequencing animations, choreographing keyframes, or when the user asks about animation sequencing, timelines, or animation order (in GSAP or when recommending a library that supports timelines). --- ## When to Use This Skill ## Creating a Timeline ## Position Parameter ## Timeline Defaults ## Timeline Options (constructor) ## Labels
Encabezado y títulos de sección leídos del archivo original el 14/09/2026 · 4.338 caracteres en total

01 Qué hace

Qué Hace el Skill gsap-timeline en Claude Code y Codex

Resumen, flujo de trabajo y resultados, todo leído del SKILL.md del skill.

Del SKILL.mdLeído 2026-09-14 · no es una ejecución registrada

En los propios términos del Skill

Un skill oficial de GSAP para secuenciar animaciones con gsap.timeline(). Cubre la creación de una timeline y el encadenamiento de tweens que se añaden por defecto, y luego cómo reposicionarlos con el parámetro position: segundos absolutos, desplazamientos relativos "+=0.5"/"-=0.2", labels y ubicación con "<"/">".

Documenta las opciones del constructor de la timeline (paused, repeat, yoyo, onComplete/onStart/onUpdate, defaults), el etiquetado con addLabel() y la navegación con play()/tweenFromTo(), el anidamiento de timelines hijas en una maestra, y los métodos de reproducción, incluyendo restart, time, progress y kill. Termina con las buenas prácticas de GSAP y las trampas que evitar, en particular encadenar con delay y colocar ScrollTrigger en tweens dentro de una timeline.

Qué produce

  • Un objeto timeline almacenado en una variable, la tl en cada ejemplo, al que se añaden los tweens encadenados y sobre el que actúan los métodos de reproducción.
  • Un nuevo Tween devuelto por tweenFromTo que anima el playhead entre dos labels mientras la timeline está en pausa, sin ease.
  • Una timeline eliminada: llamar a kill() elimina la timeline y, por defecto, también sus hijos.
Ver el ejemplo de prompt ↗

Cómo funciona

  1. 01
    Crear una Timeline y Encadenar Tweens

    Llame a gsap.timeline() y encadene llamadas a .to(). Sin una position especificada, cada tween se añade después de que termine el anterior, por lo que el orden es el orden en que lo escribe.

  2. 02
    Ubique Cada Tween en el Tiempo

    La ubicación se define mediante el tercer argumento o una propiedad position en vars: segundos absolutos, desplazamientos relativos, nombres de labels, o < y > relativos a la animación añadida más recientemente.

  3. 03
    Otorgue Valores por Defecto Compartidos a la Timeline

    Los valores por defecto entregados al constructor de la timeline se combinan en cada tween hijo, de modo que la duración y el ease se declaran una sola vez para toda la secuencia.

  4. 04
    Marcar momentos clave

    addLabel() marca un punto con nombre en la línea de tiempo, y esa etiqueta puede usarse después como destino de posición para tweens posteriores en lugar de un número sin procesar.

  5. 05
    Anidar líneas de tiempo dentro de una maestra

    Una línea de tiempo maestra puede tomar una línea de tiempo hija como una unidad y colocarla en un momento determinado, después del cual se añaden más tweens en relación con ella.

  6. 06
    Controlar toda la secuencia a la vez

    Una vez construida, la línea de tiempo se reproduce y se pausa como una sola unidad en lugar de tween por tween.

02 Encuentra tu caso de uso

Cuándo Usar el Skill gsap-timeline

Use el skill gsap-timeline en Claude Code o Codex cuando el trabajo sea de motion y video de este tipo. El ajuste y los límites a continuación se toman del propio archivo del skill.

Buen caso de uso

  • Construir una animación de varios pasos donde varios tweens deben ejecutarse en secuencia o en paralelo.
  • Cuando el usuario pregunta sobre líneas de tiempo, secuenciación o animación al estilo keyframe en GSAP.
  • Líneas de tiempo controladas por scroll, que el archivo combina con el skill scroll-trigger.

Conozca los límites

  • Un tween único o un ease por sí solo quedan fuera del alcance; el archivo redirige eso al skill core.

Qué proporcionar

  • Un target y vars para cada tween hijoCada llamada .to() encadenada toma un selector y un objeto vars; la línea de tiempo los compone en una sola secuencia.
  • repeat y yoyo a nivel de línea de tiemporepeat y yoyo se comportan igual que en los tweens, pero se aplican a toda la línea de tiempo en lugar de a un solo tween.
  • Callbacks a nivel de línea de tiempoonComplete, onStart y onUpdate se pasan a nivel de línea de tiempo, por lo que se disparan para la secuencia en su conjunto.

03 Dentro del skill

Reglas que el skill gsap-timeline le da a Claude Code y Codex

8 instrucciones concretas, valores por defecto y límites que SKILL.md fija para el agente: la parte del archivo que cambia el resultado.

  1. Sin encadenar con delay

    No encadenar animaciones con delay cuando una línea de tiempo puede secuenciarlas; el archivo remite a gsap.timeline() y al parámetro de posición para animaciones de varios pasos.

  2. El parámetro de posición en lugar de adivinar

    Usar siempre el parámetro de posición, el tercer argumento, para colocar tweens en momentos específicos o en relación con etiquetas.

  3. Nombra tus etiquetas

    Añadir etiquetas con addLabel() para que la secuenciación se mantenga legible y fácil de mantener.

  4. Valores por defecto en el constructor

    Pasar defaults al constructor de la línea de tiempo para que los tweens hijos hereden duration, ease y vars similares en lugar de repetirlos en cada tween.

  5. ScrollTrigger va en la línea de tiempo

    Colocar ScrollTrigger en la línea de tiempo o en el tween de nivel superior, nunca en tweens dentro de una línea de tiempo.

  6. Nunca anide una animación ScrollTrigger

    Las animaciones que contienen un ScrollTrigger no deben anidarse; los ScrollTrigger pertenecen únicamente a Tweens o Timelines de nivel superior.

  7. La duración del constructor no es la longitud de la secuencia

    No interprete la duración del constructor del timeline como la duración del tween: el archivo lo señala como un error común.

  8. Conozca la colocación predeterminada

    ">" inicia un tween cuando termina la animación agregada recientemente y es la colocación predeterminada, mientras que "<" lo alinea con el inicio de esa animación.

04 Ponlo a trabajar

Instalar gsap-timeline en Claude Code o Codex

Un comando npx skills add, luego una primera tarea en tu agente y una lista de verificación para el resultado.

Añadir gsap-timeline a Claude Code, Codex o Su Agente

Ejecútelo en su proyecto; el instalador pregunta a qué agente añadirlo.

Terminal
npx skills add https://github.com/greensock/gsap-skills --skill gsap-timeline

Forma genérica de la CLI skills para skills/gsap-timeline/SKILL.md; el repositorio puede documentar su propia ruta.

Dale al Skill una Primera Tarea de Motion y Video

Redactado en los términos del propio skill; sustituya las partes entre corchetes por su material.

Starter prompt
I'm sequencing a [hero banner] animation: [the headline] slides up, then [the CTA button] appears 0.5s later, and [the product shot] scales in at the same start time as the button. I want shared duration and ease defaults on the timeline, and labels for the intro and outro so I can play from either one.

Fuente: redactado a partir del SKILL.md en los términos del propio skill.

Revisa el primer resultado

Lo que el propio SKILL.md indica que debe ser un resultado correcto:

  • Lleve el playhead a un segundo específico con tl.time(2) y confirme que cada tween comienza donde lo indica el parámetro de posición.
  • Compruebe que los valores predeterminados realmente llegaron a los hijos: en el ejemplo del archivo ambos tweens usan 0.5s y power2.out sin repetirlos.
  • Reproduzca desde el nombre de una etiqueta para confirmar que la etiqueta se agregó en el momento esperado.
  • Invierta para previsualizar la secuencia hacia atrás; el archivo muestra progress(1) antes de reverse() para que el timeline se reproduzca completamente en reversa.

En OpenDesign gsap-timeline viene incluido: Plugins → Skills, selecciónelo en la barra superior.

05 Código abierto, rastreable

Fuente, Licencia y Verificación

De dónde provienen los datos de esta página y cuándo se verificaron por última vez.

Author
GreenSock
Archivo de skill
skills/gsap-timeline/SKILL.md Suma de verificación del contenido registrada en la verificación; commit aed9cfd
License
MIT De LICENSE; SKILL.md dice "MIT".
Estrellas del repositorio
15.248 Instantánea de GitHub tomada el 2026-09-14 para todo el repositorio greensock/gsap-skills, que contiene 8 skills en este catálogo. No es una calificación o recuento de uso para gsap-timeline.
Verificado por OpenDesign
14-09-2026 Se verificaron el archivo fuente, la ruta, el texto de licencia y el recuento de estrellas. Incluido en OpenDesign main (verificado el 28-08-2026); no se ha registrado una ejecución real en esta página.

Dentro del SKILL.md

  1. Cuándo usar este skillSe aplica a animaciones y secuencias de varios pasos; hace referencia cruzada a los skills core, scroll-trigger y React.
  2. Creación de un timelinegsap.timeline() con llamadas .to() encadenadas; los tweens se añaden por defecto a menos que se reposicionen.
  3. Parámetro de posiciónTercer argumento o propiedad vars: desplazamientos absolutos, relativos, etiquetas y colocación con corchetes angulares.
  4. Valores predeterminados del timelineLos valores predeterminados pasados al constructor del timeline son heredados por cada tween hijo.
  5. Opciones del timeline (constructor)paused, repeat, yoyo, callbacks a nivel de timeline, y el objeto defaults entregado a los hijos.
  6. EtiquetasaddLabel(), luego play() y tweenFromTo() para iniciar desde puntos etiquetados.
  7. Anidamiento de timelinesUn timeline maestro puede contener timelines hijos mediante master.add(child, 0).
  8. Control de la reproducciónplay, pause, reverse, restart, time, progress y kill listados para el timeline.
  9. Buenas prácticas oficiales de GSAPCinco prácticas marcadas con check: timelines en lugar de delays, parámetro de posición, etiquetas, valores predeterminados, ScrollTrigger de nivel superior.
  10. No hacerCuatro errores marcados con cruz, incluyendo encadenamiento de delays, valores predeterminados omitidos y ScrollTriggers anidados.
La descripción propia del Skill
"Skill oficial de GSAP para timelines — gsap.timeline(), parámetro position, anidación, reproducción. Use cuando secuencie animaciones, coreografíe keyframes, o cuando el usuario pregunte sobre secuenciación de animación, timelines u orden de animación (en GSAP o al recomendar una biblioteca que soporte timelines)."

Descripción del front-matter de SKILL.md. El archivo completo tiene aproximadamente 4.338 caracteres. Lea el archivo completo en GitHub.

06 Antes de instalar

Preguntas sobre el skill gsap-timeline

Las respuestas provienen del SKILL.md tal como se leyó el 2026-09-14, no de una ejecución registrada.

¿Cómo construyo un timeline que no comience hasta que yo lo active?

Créela con paused: true en el constructor, lo que deja el timeline pausado, y llame a .play() cuando quiera que se ejecute.

GSAP Timeline

Ejecutar gsap-timeline en una Tarea Real de Motion y Video.

El skill gsap-timeline viene incluido dentro de OpenDesign. Descargue la aplicación, seleccione el skill en Plugins → Skills, pegue el prompt anterior y lea el plan antes del resultado.

Terminal
npx skills add https://github.com/greensock/gsap-skills --skill gsap-timeline