Communitygithub.com

video-editing-toolkit

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 video-editing-toolkit?

Este skill proporciona una referencia completa de la biblioteca GSAP (GreenSock Animation Platform) enfocada en su uso dentro del marco de trabajo HyperFrames. Está diseñado para desarrolladores y agentes de IA que necesitan crear animaciones eficientes y de alto rendimiento en composiciones web. El resumen cubre los métodos principales de interpolación (to, from, fromTo, set), propiedades comunes (duración, retardo, easing, stagger, repetición), transformaciones CSS preferidas (como x, y, scale, rotation) y el uso de variables especiales (autoAlpha, CSS variables, rotación direccional, valores relativos). Además, explica en detalle la creación y control de timelines (con parámetro de posición, etiquetas y anidamiento), el uso de gsap.matchMedia() para animaciones responsivas y accesibles, y consejos de rendimiento (animar solo transform y opacidad, will-change, gsap.quickTo() para actualizaciones frecuentes). Incluye una sección de mejores prácticas y advertencias sobre qué no hacer (como animar propiedades de layout o encadenar animaciones con delay). El skill también referencia un archivo externo con efectos prediseñados para HyperFrames. En general, sirve como guía autorizada para generar animaciones GSAP correctas, eficientes y mantenibles.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/govindgoel2001/video-editing-toolkit/tree/HEAD/vendor/hyperframes-skills/gsap

Preguntar en tu IA favorita

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

Documentación

GSAP

Métodos de Interpolación Principales

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

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

Propiedades comunes (vars)

  • duration — segundos (por defecto 0.5).
  • delay — segundos antes de comenzar.
  • ease — "power1.out" (por defecto), "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 (por defecto), true, o "auto".
  • repeat — número o -1 para infinito. yoyo — alterna dirección con repetición.
  • onComplete, onStart, onUpdate — callbacks.
  • immediateRender — por defecto true para from()/fromTo(). Ponlo en false en interpolaciones posteriores que apunten a la misma propiedad+elemento para evitar sobrescritura.

Transformaciones y CSS

Prefiere los alias de transformación de GSAP en lugar de 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

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

Valores por Defecto

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

Control de Interpolaciones

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,
    });
  },
);

Líneas de Tiempo (Timelines)

Crear una Línea de Tiempo

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 ubicació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 Línea de Tiempo

  • paused: true — crea pausada; llama a .play() para iniciar.
  • repeat, yoyo — aplica a toda la línea de tiempo.
  • defaults — vars se fusionan en cada interpolación hija.

Anidamiento de Líneas de Tiempo

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 animen.

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 > Muchas Interpolaciones

Usa stagger en lugar de interpolaciones separadas con retrasos manuales.

Limpieza

Pausa o elimina (kill) las animaciones fuera de pantalla.


Referencias (cargadas bajo demanda)

  • references/effects.md — Efectos prefabricados: texto de máquina de escribir, visualizador de audio. Léelo cuando necesites patrones de efectos ya preparados para HyperFrames.

Mejores Prácticas

  • Usa nombres de propiedades en camelCase; prefiere alias de transformación y autoAlpha.
  • Prefiere líneas de tiempo 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 líneas de tiempo.
  • Almacena el valor de retorno de 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 línea de tiempo pueda secuenciarlas.
  • Crear interpolaciones antes de que exista el DOM.
  • Omitir la limpieza — siempre elimina (kill) las interpolaciones cuando ya no sean necesarias.

Individual skills in this repo

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

govindgoel2001/video-editing-toolkit

HyperFrames CLI tool — hyperframes init, lint, inspect, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. Use when scaffolding a project, linting, validating, inspecting visual layout in compositions, previewing in the studio, rendering to video, transcribing audio, generating TTS, or troubleshooting the HyperFrames environment.

govindgoel2001/video-editing-toolkit

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

govindgoel2001/video-editing-toolkit

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For CLI commands (init, lint, preview, render, transcribe, tts) see the hyperframes-cli skill.

govindgoel2001/video-editing-toolkit

Capture a website and create a HyperFrames video from it. Use when: (1) a user provides a URL and wants a video, (2) someone says "capture this site", "turn this into a video", "make a promo from my site", (3) the user wants a social ad, product tour, or any video based on an existing website, (4) the user shares a link and asks for any kind of video content. Even if the user just pastes a URL — this is the skill to use.

govindgoel2001/video-editing-toolkit

Edit any video by conversation. Transcribe, cut, color grade, generate overlay animations, burn subtitles — for talking heads, montages, tutorials, travel, interviews. No presets, no menus. Ask questions, confirm the plan, execute, iterate, persist. Production-correctness rules are hard; everything else is artistic freedom.

govindgoel2001/video-editing-toolkit

Production pipeline for mathematical and technical animations using Manim Community Edition. Creates 3Blue1Brown-style explainer videos, algorithm visualizations, equation derivations, architecture diagrams, and data stories. Use when users request: animated explanations, math animations, concept visualizations, algorithm walkthroughs, technical explainers, 3Blue1Brown style videos, or any programmatic animation with geometric/mathematical content.

Skills relacionados