Communitygithub.com

shengdabai/Tony-Claude-Code-Skills

Referencia de animación GSAP para HyperFrames. Cubre gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), parámetro de posición, etiquetas, anidamiento, reproducción) y rendimiento (transformaciones, will-change, quickTo). Úsalo al escribir animaciones GSAP en composiciones de HyperFrames.

¿Qué es Tony-Claude-Code-Skills?

Esta skill proporciona una referencia completa de GSAP adaptada al entorno HyperFrames, explicando cómo crear animaciones de video finitas mediante timelines en pausa registradas en `window.__timelines`. Cubre los métodos principales de tween (`gsap.to()`, `from()`, `fromTo()`), propiedades comunes como `duration`, `ease`, `stagger` y `repeat`, y detalla el uso del parámetro de posición, etiquetas y anidamiento de timelines para un control preciso de la secuencia. Incluye secciones de rendimiento con `will-change`, `gsap.quickTo()` y la preferencia por transformaciones sobre propiedades de layout. También aborda la accesibilidad con `gsap.matchMedia()` y las mejores prácticas para evitar bucles infinitos y limpiar animaciones. Está diseñada para que desarrolladores que trabajan con HyperFrames puedan integrar animaciones GSAP de manera eficiente y sin errores, siguiendo un contrato claro de registro y ejecución.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/shengdabai/Tony-Claude-Code-Skills/tree/HEAD/skills/hyperframes-gsap

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

GSAP

Contrato HyperFrames

HyperFrames controla GSAP a través de su adaptador de tiempo de ejecución gsap. Crea una timeline en pausa de forma síncrona, regístrala en window.__timelines con el data-composition-id exacto y deja que HyperFrames la controle.

<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/gsap.min.js"></script>
<script>
  window.__timelines = window.__timelines || {};
  const tl = gsap.timeline({ paused: true });

  tl.from(".title", { y: 48, opacity: 0, duration: 0.6, ease: "power3.out" }, 0);
  tl.to(".accent", { scaleX: 1, duration: 0.5, ease: "power2.out" }, 0.25);

  window.__timelines["main"] = tl; // la clave debe coincidir con data-composition-id en la raíz de la composición
</script>
  • La clave del registro debe coincidir con el data-composition-id de la raíz de la composición.
  • No llames a tl.play() para movimientos críticos de renderizado.
  • No construyas timelines dentro de código asíncrono, temporizadores o manejadores de eventos.
  • Mantén los bucles finitos. HyperFrames renderiza duraciones de video finitas.

Métodos Centrales de Tween

  • gsap.to(targets, vars) — anima desde el estado actual a vars. El más común.
  • gsap.from(targets, vars) — anima desde vars al estado actual (entradas).
  • gsap.fromTo(targets, fromVars, toVars) — inicio y fin explícitos.
  • gsap.set(targets, vars) — aplica inmediatamente (duración 0).

Usa siempre nombres de propiedades en camelCase (ej. backgroundColor, rotationX).

vars Comunes

  • duration — segundos (predeterminado 0.5).
  • delay — segundos antes de iniciar.
  • ease — "power1.out" (predeterminado), "power3.inOut", "back.out(1.7)", "elastic.out(1, 0.3)", "none".
  • stagger — número 0.1 u objeto: { amount: 0.3, from: "center" }, { each: 0.1, from: "random" }.
  • overwrite — false (predeterminado), true o "auto".
  • repeat — número finito; nunca -1 en HyperFrames. Calcula las repeticiones a partir de la duración visible. yoyo — alterna dirección con repeat.
  • onComplete, onStart, onUpdate — callbacks.
  • immediateRender — predeterminado true para from()/fromTo(). Establécelo en false en tweens posteriores que afecten a la misma propiedad+elemento para evitar sobrescritura.

Transformaciones y CSS

Prefiere los alias de transformación de GSAP sobre la cadena transform sin procesar:

Propiedad GSAPEquivalente
x, y, ztranslateX/Y/Z (px)
xPercent, yPercenttranslateX/Y en %
scale, scaleX, scaleYscale
rotationrotate (grados)
rotationX, rotationYrotate 3D
skewX, skewYskew
transformOrigintransform-origin
  • autoAlpha — prefiérelo sobre opacity. En 0: también establece visibility: hidden.
  • Variables CSS — "--hue": 180.
  • svgOrigin (solo SVG) — origen en el espacio de coordenadas SVG global. No lo combines con transformOrigin.
  • Rotación direccional — "360_cw", "-170_short", "90_ccw".
  • clearProps — "all" o separado por comas; elimina estilos en línea al completarse.
  • Valores relativos — "+=20", "-=10", "*=2".

Valores Basados en Funciones

gsap.to(".item", {
  x: (i, target, targets) => i * 50,
  stagger: 0.1,
});

Easing

Eases integrados: power1–power4, back, bounce, circ, elastic, expo, sine. Cada uno tiene .in, .out, .inOut.

Valores Predeterminados

gsap.defaults({ duration: 0.6, ease: "power2.out" });

Control de Tweens

const tween = gsap.to(".box", { x: 100 });
tween.pause();
tween.play();
tween.reverse();
tween.kill();
tween.progress(0.5);
tween.time(0.2);

gsap.matchMedia() (Responsive + Accesibilidad)

Ejecuta la configuración solo cuando una media query coincide; se revierte automáticamente cuando deja de coincidir.

let mm = gsap.matchMedia();
mm.add(
  {
    isDesktop: "(min-width: 800px)",
    reduceMotion: "(prefers-reduced-motion: reduce)",
  },
  (context) => {
    const { isDesktop, reduceMotion } = context.conditions;
    gsap.to(".box", {
      rotation: isDesktop ? 360 : 180,
      duration: reduceMotion ? 0 : 2,
    });
  },
);

Timelines

Creando una Timeline

const tl = gsap.timeline({ defaults: { duration: 0.5, ease: "power2.out" } });
tl.to(".a", { x: 100 }).to(".b", { y: 50 }).to(".c", { opacity: 0 });

Parámetro de Posición

El tercer argumento controla la colocación:

  • Absoluto: 1 — en 1s
  • Relativo: "+=0.5" — después del final; "-=0.2" — antes del final
  • Etiqueta: "intro", "intro+=0.3"
  • Alineación: "<" — mismo inicio que el anterior; ">" — después de que el anterior termine; "<0.2" — 0.2s después de que el anterior comience
tl.to(".a", { x: 100 }, 0);
tl.to(".b", { y: 50 }, "<"); // mismo inicio que .a
tl.to(".c", { opacity: 0 }, "<0.2"); // 0.2s después de que .b comience

Etiquetas

tl.addLabel("intro", 0);
tl.to(".a", { x: 100 }, "intro");
tl.addLabel("outro", "+=0.5");
tl.play("outro");
tl.tweenFromTo("intro", "outro");

Opciones de Timeline

  • paused: true — créala en pausa; llama a .play() para iniciar.
  • repeat, yoyo — aplica a toda la timeline.
  • defaults — vars se fusionan en cada tween hijo.

Anidamiento de Timelines

const master = gsap.timeline();
const child = gsap.timeline();
child.to(".a", { x: 100 }).to(".b", { y: 50 });
master.add(child, 0);

Control de Reproducción

tl.play(), tl.pause(), tl.reverse(), tl.restart(), tl.time(2), tl.progress(0.5), tl.kill().


Rendimiento

Prefiere Transform y Opacity

Animar x, y, scale, rotation, opacity se mantiene en el compositor. Evita width, height, top, left cuando las transformaciones logren el mismo efecto.

will-change

will-change: transform;

Solo en elementos que realmente animan.

gsap.quickTo() para Actualizaciones Frecuentes

let xTo = gsap.quickTo("#id", "x", { duration: 0.4, ease: "power3" }),
  yTo = gsap.quickTo("#id", "y", { duration: 0.4, ease: "power3" });
container.addEventListener("mousemove", (e) => {
  xTo(e.pageX);
  yTo(e.pageY);
});

Stagger > Muchos Tweens

Usa stagger en lugar de tweens separados con delays manuales.

Limpieza

Pausa o elimina animaciones fuera de pantalla.


Referencias (cargadas bajo demanda)

  • references/effects.md — Efectos listos para usar: texto de máquina de escribir, visualizador de audio. Lee cuando necesites patrones de efectos ya hechos para HyperFrames.

Buenas Prácticas

  • Usa nombres de propiedades en camelCase; prefiere alias de transformación y autoAlpha.
  • Prefiere timelines sobre encadenamiento con delay; usa el parámetro de posición.
  • Añade etiquetas con addLabel() para una secuenciación legible.
  • Pasa defaults al constructor de la timeline.
  • Almacena el valor de retorno del tween/timeline cuando controles la reproducción.

No Hacer

  • Animar propiedades de layout (width/height/top/left) cuando las transformaciones sean suficientes.
  • Usar tanto svgOrigin como transformOrigin en el mismo elemento SVG.
  • Encadenar animaciones con delay cuando una timeline pueda secuenciarlas.
  • Crear tweens antes de que exista el DOM.
  • Omitir la limpieza — siempre elimina los tweens cuando ya no sean necesarios.
  • Usar valores de repetición infinitos en composiciones de HyperFrames. Usa recuentos de repetición finitos calculados a partir de la duración visible.

Créditos y Referencias

Individual skills in this repo

This repo contains 8 individual skills — each has its own dedicated page.

shengdabai/Tony-Claude-Code-Skills

Downloads videos from YouTube and other platforms for offline viewing, editing, or archival. Handles various formats and quality options.

shengdabai/Tony-Claude-Code-Skills

接收抖音、小红书、微信视频号等短视频链接或分享文案,查询作品/账号数据并提取语音文字稿,按作者和标题归档为 Markdown。用户希望完整解析短视频、取得数据或文字稿时使用;运行前检查 TikHub 与轻抖使用凭证,缺少时用新手能理解的方式引导购买和安全配置。

shengdabai/Tony-Claude-Code-Skills

Read-only queue dashboard for workspace-aware ship. (gstack)

shengdabai/Tony-Claude-Code-Skills

Anime.js adapter patterns for HyperFrames. Use when writing Anime.js animations or timelines inside HyperFrames compositions, registering animations on window.__hfAnime, making Anime.js seek-driven and deterministic, or translating Anime.js examples into render-safe HyperFrames HTML.

shengdabai/Tony-Claude-Code-Skills

Author a new HyperFrames registry block (caption style, VFX block, transition, lower third) or component (text effect, overlay, snippet) and ship it as an upstream PR to the hyperframes repo. Use ONLY when the user wants to CONTRIBUTE to the public catalog — for in-project caption/transition authoring use the `hyperframes` skill, for installing existing registry items use the `hyperframes-registry` skill.

shengdabai/Tony-Claude-Code-Skills

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

shengdabai/Tony-Claude-Code-Skills

HyperFrames CLI dev loop — `npx hyperframes` for scaffolding (init), validation (lint, inspect), preview, render, and environment troubleshooting (doctor, browser, info, upgrade). Use when running any of these commands or troubleshooting the HyperFrames build/render environment. For asset preprocessing commands (`tts`, `transcribe`, `remove-background`), invoke the `hyperframes-media` skill instead.

shengdabai/Tony-Claude-Code-Skills

Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.

Skills relacionados