Communitygithub.com

nateherkai/hyperframes-student-kit

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 hyperframes-student-kit?

Este skill proporciona una referencia completa y detallada de la biblioteca de animación GSAP (GreenSock Animation Platform) específicamente diseñada para su uso en composiciones de HyperFrames. Es una guía indispensable para desarrolladores que necesitan implementar animaciones fluidas y de alto rendimiento en sus proyectos con HyperFrames. El skill cubre todos los métodos tween core (to, from, fromTo, set), las propiedades comunes (duration, delay, ease, stagger, repeat), el manejo de transformaciones y propiedades CSS, la creación y control de timelines (con parámetro de posición, etiquetas y anidamiento), y consejos de rendimiento como el uso de quickTo, will-change y la preferencia por animar transformaciones y opacidad. Además, incluye un apartado de easing con los tipos de interpolación disponibles y referencias a efectos predefinidos en el archivo references/effects.md. Está optimizado para plataformas como Cursor y Claude Code, donde el agente puede consultar estos detalles para generar código GSAP preciso y eficiente.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nateherkai/hyperframes-student-kit/tree/HEAD/.agents/skills/gsap

Preguntar en tu IA favorita

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

Documentación

GSAP

Métodos Tween Principales

  • 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 (por defecto 0.5).
  • delay — segundos antes de empezar.
  • 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 repeat.
  • onComplete, onStart, onUpdate — callbacks.
  • immediateRender — por defecto true en from()/fromTo(). Ponlo false en tweens posteriores que apunten a la misma propiedad+elemento para evitar sobrescrituras.

Transformaciones y CSS

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

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

Valores Basados en Funciones

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

Easing

Eases 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 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; 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 ubicación:

  • Absoluto: 1 — en 1s
  • Relativo: "+=0.5" — al 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 — crea pausada; llama a .play() para iniciar.
  • repeat, yoyo — se aplican a toda la timeline.
  • defaults — vars se mezclan 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 permanece 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 > Muchos Tweens

Usa stagger en lugar de tweens separados con delays manuales.

Limpieza

Pausa o mata animaciones fuera de pantalla.


Referencias (cargadas bajo demanda)

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

Mejores Prácticas

  • Usa nombres de propiedades en camelCase; prefiere alias de transformación y autoAlpha.
  • Prefiere timelines sobre encadenar 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.
  • Guarda 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.
  • Saltar la limpieza — siempre mata los tweens cuando ya no sean necesarios.

Individual skills in this repo

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

nateherkai/hyperframes-student-kit

Agent 2 of the video editing pipeline. Finds and removes spoken mistakes — stutters, repeated words, false starts, and retakes (re-recorded lines) — from a talking-head recording. Use after cut-silences, when asked to cut mistakes, remove stutters / repeats / filler restarts, clean up flubs, or keep the best take. Works review-gated: it proposes every cut with context and a reason for approval, then renders only the approved cuts via ffmpeg. Requires a word-level transcript.

nateherkai/hyperframes-student-kit

Agent 1 of the video editing pipeline. Removes silences and dead air from a talking-head recording. Use when asked to cut silences, trim pauses, remove dead air / gaps, or tighten the pacing of a raw video, given a word-level transcript. Produces an edit list (EDL), a re-timed transcript for downstream agents, and optionally the cut video via ffmpeg. Does NOT cut mistakes, repeats, or false starts — that is the cut-mistakes agent.

nateherkai/hyperframes-student-kit

Edit a raw talking-head video through transcription, silence trimming, mistake review, visual storytelling, motion graphics, and verified HyperFrames rendering. Use for a complete edit; route a single requested operation directly to its specialist skill.

nateherkai/hyperframes-student-kit

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

nateherkai/hyperframes-student-kit

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.

nateherkai/hyperframes-student-kit

Plan, write, time, style, and validate motion-graphic beats for long-form talking-head HyperFrames videos. Use when Codex is asked to add or improve visual beats, glassmorphism lower thirds, crumpled-paper full-screen takeovers, transcript-synced callouts, pacing coverage, YouTube retention graphics, or render-ready overlays in an existing HyperFrames video project.

nateherkai/motion-showreel

Build 10–30s motion-design showreels in the style of Nate's Opus 5.5 CLAUDE/MOTION REEL — brand motif chapters, HUD, BPM-locked cuts, logo lockup.

nateherkai/website-to-hyperframes

Capture a website URL and produce a HyperFrames promo/product-tour video — site → finished marketing video outcome.

Skills relacionados