Communitygithub.com

HyperFrames Keyframes

Crea keyframes seek-safe en 2D/3D, líneas de tiempo GSAP, animaciones CSS, Anime.js, WAAPI, FLIP, rutas, máscaras, morph/dibujo SVG, estelas de texto, profundidad 3D o diagnósticos de `hyperframes keyframes`.

¿Qué es HyperFrames Keyframes?

HyperFrames Keyframes es un skill especializado para Claude Code (o agentes similares) que define un contrato riguroso para crear animaciones seek-safe (que se pueden pausar y reproducir en cualquier punto). Proporciona procedimientos claros para elegir el mecanismo de animación más pequeño que demuestre una idea (desde transiciones CSS hasta Three.js), reglas de registro de motores como GSAP, Anime.js y WAAPI, y un flujo de verificación basado en lint, validación y capturas de pantalla (`--shot`). El skill cubre desde keyframes simples hasta animaciones complejas de lienzo/WebGL, morfología SVG, profundidad 3D y animación de texto, con énfasis en la identidad continua del sujeto, estados visibles y tiempos deterministas. Es útil para desarrolladores que construyen composiciones animadas con HyperFrames y necesitan garantizar que los keyframes sean correctos, reutilizables y depurables.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/sansayan01/finance_app_zo/tree/HEAD/.agents/skills/hyperframes-keyframes

Preguntar en tu IA favorita

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

Documentación

¿Qué hace HyperFrames Keyframes?

Los keyframes son un contrato de pose: estados visibles, identidad continua del sujeto, runtime seek-safe, píxeles verificados.

Usa hyperframes-animation para recetas de escenas amplias. Usa hyperframes-cli para la documentación completa de comandos. Usa references/keyframe-patterns.md solo al elegir mecanismos de implementación, no el estilo visual.

Procedimiento

  1. Identifica el sujeto animado, los estados visibles, el estado final y el runtime.
  2. Elige el mecanismo más pequeño que demuestre la instrucción. Lee references/keyframe-patterns.md solo si el mecanismo no está claro.
  3. Crea keyframes seek-safe en el runtime declarado. Construye de forma síncrona y registra la instancia del runtime.
  4. Verifica con lint, validación, hyperframes keyframes, un --shot enfocado y capturas de pantalla en los puntos de prueba.
  5. Si la prueba falla, corrige los keyframes fuente y vuelve a ejecutar el diagnóstico fallido más pequeño antes de renderizar.

Contrato

  • Nombra el sujeto en movimiento.
  • Nombra las poses necesarias para demostrar el movimiento previsto, incluido el estado final.
  • Keyframe en canales visibles, no en estado auxiliar oculto.
  • Preserva la identidad del objeto cuando la continuidad importe.
  • Funde solo cuando el movimiento previsto sea reemplazo o disolución.
  • Mantén los estados legibles o semánticos el tiempo suficiente para verlos.
  • El fotograma final es parte de la animación, no una limpieza.
  • No vuelvas al estado de reposo a menos que se solicite.
  • No termines en negro a menos que se solicite.
  • Si editas una escena inicial, conserva el diseño, el texto, los activos, los colores y el estado final a menos que se te pida rediseñar.

Reglas del Runtime

GSAP:

  • construye de forma síncrona al cargar la página
  • usa gsap.timeline({ paused: true })
  • registra como window.__timelines[compositionId]
  • la clave del registro debe coincidir con data-composition-id
  • no llames a tl.play() para movimientos críticos de render
  • mantén las repeticiones finitas

Keyframes CSS:

  • duración finita y número de iteraciones
  • retardo determinista
  • animation-fill-mode: both
  • usa data-start cuando el tiempo pertenezca a un clip

Anime.js:

  • crea de forma síncrona
  • autoplay: false
  • duración y bucles finitos
  • inserta cada instancia en window.__hfAnime

WAAPI:

  • duration finita
  • fill: "both"
  • construcción determinista
  • la superficie de texto no lista WAAPI; verifica con --shot (busca WAAPI) y capturas de pantalla

Nunca uses para movimientos críticos de render:

  • Date.now()
  • performance.now()
  • Math.random() sin semilla
  • disparadores hover/scroll
  • temporizadores
  • líneas de tiempo creadas de forma asíncrona
  • requestAnimationFrame no registrado
  • bucles infinitos

Esqueleto GSAP

const root = document.querySelector("[data-composition-id]");
const compositionId = root.dataset.compositionId;
const tl = gsap.timeline({ paused: true });

tl.addLabel("state-a", 0);
tl.to(".subject", {
  keyframes: [
    { x: 0, opacity: 1, duration: 0.2 },
    { x: 120, opacity: 1, duration: 0.4, ease: "power2.out" },
    { x: 100, opacity: 1, duration: 0.2, ease: "power2.inOut" },
  ],
  ease: "none",
});

window.__timelines = window.__timelines || {};
window.__timelines[compositionId] = tl;

Usa etiquetas para estados semánticos. Usa parámetros de posición en lugar de retardos encadenados. Usa immediateRender: false para interpolaciones from()/fromTo() posteriores que toquen la misma propiedad.

Formas de Keyframe

  • Keyframes de array: escalera de poses con duración/ease por paso.
  • Keyframes porcentuales: tiempo exacto dentro de una interpolación.
  • Matrices de propiedades: cambios multi-parada compactos.
  • ease: "none" en el padre cuando cada parada tenga su propio easing.
  • easeEach cuando cada segmento deba compartir la misma sensación.

No copies distancias numéricas o tiempos de los ejemplos. Dedúcelos de la geometría y duración reales de la composición.

Para un sujeto que se mueve entre dos cajas, prefiere una interpolación de transformación continua o FLIP. Divide x/y/scale en varios keyframes con ease solo cuando el espectador deba sentir pulsos distintos; cada segmento cambia la velocidad y puede percibirse como un tirón.

Canales

Prefiere canales del compositor/visuales: x/y/z, xPercent/yPercent, scale, rotationX/Y/Z, skew, transformOrigin, svgOrigin, opacity, autoAlpha, clip-path, máscaras, variables CSS, valores de ruta/dash SVG, transformaciones de cámara, uniforms de shader.

Evita canales de diseño/ciclo de vida: top/left/right/bottom, width/height, margin/padding, display, visibility, creación tardía de DOM, superposiciones auxiliares que realicen el movimiento del sujeto.

Elección del Mecanismo

Elige el mecanismo más pequeño que demuestre la instrucción:

NecesidadMecanismo
El mismo sujeto cambia de caja o jerarquíaElemento compartido / FLIP
El sujeto recorre una ruta visibleViaje por ruta
El trazo crece o trazaDibujo de trazo
Una forma se convierte en otraInterpolación de formas
El límite de revelación es visibleClip, máscara o uniforme de shader
Muchos elementos se mueven con ordenEscalonado / retardo indexado
El texto en sí se mueveSubdivisión de línea, palabra, carácter o banda
La superficie se dobla, estira o recortaContratransformación padre/hijo
La interfaz tiene estadosMáquina de estados explícita
La escena tiene profundidadKeyframes de objetos/cámara 3D DOM, Three.js o WebGL

Los mecanismos pueden combinarse, pero cada uno debe aclarar la idea. La decoración no es una demostración.

Tiempo

  • Anticipación solo cuando aclare causa o dirección.
  • La aceleración abandona el reposo.
  • La prueba máxima muestra el mecanismo de manera inequívoca.
  • El seguimiento vende energía y dirección.
  • Sobrepaso solo cuando el sujeto deba sentirse elástico o táctil.
  • El viaje por ruta a velocidad constante suele necesitar ease: "none".
  • Los estados discretos de interfaz suelen necesitar un ease-out pronunciado.
  • Los elementos repetidos necesitan desplazamientos ordenados, no tiempos idénticos.
  • Los bloqueos finales necesitan pausas más largas que las poses de transición.
  • Suavidad significa velocidad continua en el mismo sujeto.
  • No superpongas interpolaciones que escriban la misma propiedad de transformación a menos que la superposición sea intencional y esté verificada.
  • Evita animar grandes cambios de clip-path/máscara mientras la misma superficie principal también se escala o viaja; usa revelaciones anidadas después de que el movimiento principal se estabilice.

Texto

Preserva las cajas de línea, el espaciado entre palabras, la legibilidad y el ajuste final. Si el texto se mueve internamente, mueve los glifos o las bandas enmascaradas, no solo las decoraciones alrededor del texto. Captura fotogramas legibles.

SVG

Para el crecimiento del trazo, prefiere DrawSVGPlugin, luego stroke-dasharray/stroke-dashoffset. Para la interpolación de formas, prefiere MorphSVGPlugin; convierte primitivas a rutas cuando sea necesario y divide siluetas complejas en partes más simples.

3D

La escala por sí sola es profundidad falsa. Usa perspectiva en un padre estable, transform-style: preserve-3d, viaje en z, rotación, movimiento de cámara/mundo, oclusión y orden de capas cuando los objetos se crucen.

Usa uno o dos ángulos de diagnóstico que expongan la relación de profundidad. Si la prueba en ángulo no muestra cruce de profundidad, mejora z/cámara/oclusión.

Lienzo / WebGL

Keyframe la posición de la cámara, el objetivo de la cámara, la transformación del objeto, la opacidad del material, los uniforms del shader y la intensidad del postprocesado a través de un estado determinista. Renderiza desde el tiempo de HyperFrames. Usa --ghost porque las cajas de marcador no pueden ver el movimiento interno del lienzo.

Prueba CLI

npx hyperframes lint
npx hyperframes check
npx hyperframes keyframes .
npx hyperframes keyframes . --json
npx hyperframes keyframes . --runtime all
npx hyperframes keyframes . --selector "<selector>" --shot "<file>" --samples <n>
npx hyperframes keyframes . --selector "<selector>" --shot "<file>" --layout strip --from <t0> --to <t1>
npx hyperframes keyframes . --shot "<file>" --ghost --angle <angle>
npx hyperframes snapshot . --at <times>

Elige <selector> para el sujeto animado real. Elige <times> para el primer fotograma, poses de prueba, final-menos-pausa y final exacto. Elige <angle> solo cuando la profundidad deba demostrarse.

HerramientaDemuestra
keyframesobjetivos, paradas explícitas, rutas, trazos, movimiento compuesto padre/hijo, paradas CSS, registro de Anime
--shotfantasmas, forma de ruta, espaciado temporal, proyección 3D DOM, prueba de selector enfocada
--layout stripmovimiento in situ, superposiciones, contacto, escala/opacidad sutiles, ondas de texto
--ghostlienzo, WebGL, movimiento de shader, 3D renderizado
snapshot --atmáscaras, legibilidad de texto, estado completo, bloqueo final, colas negras/reposo

Si la prueba del selector parece incorrecta:

  1. vuelve a ejecutar --json
  2. encuentra el objetivo animado real
  3. dispara a ese objetivo
  4. captura fotogramas completos
  5. confía en los píxeles pintados sobre los registros

Lectura de Diagnóstico

flat significa que no hay poses intermedias explícitas. keyframes significa que existen paradas explícitas. motionPath significa que existe una ruta. trace significa dibujo multi-trazo. composed with significa que el movimiento hijo hereda el movimiento padre.

El espaciado uniforme de fantasmas significa velocidad constante. Fantasmas agrupados significan entrada lenta o establecimiento. Grandes espacios significan viaje rápido.

Un disparo con selector auxiliar no es una prueba. Un disparo de superposición sobre un fotograma completo roto no es una prueba.

Manejo de Errores

FallaSolución
solo punto finalañade poses intermedias, mantén la prueba máxima, vuelve a ejecutar --shot
rotura de identidadmantén un elemento vivo, usa cajas de origen/final compartidas, elimina el fundido sustituto
3D falsoañade viaje z/cámara, oclusión, prueba en ángulo
final incorrectoañade pausa final, captura final-menos-pausa y final exacto
runtime no buscablepausa la reproducción automática, registra la instancia, elimina temporizadores, construye de forma síncrona
texto ilegiblepreserva las cajas de línea, reduce el desplazamiento, añade pausa final, captura fotogramas de texto

Finalizado

Ejecuta lint, validación, keyframes, un --shot enfocado y capturas de pantalla. Confirma el primer fotograma, las poses de prueba, el final-menos-pausa, el final exacto, el movimiento propiedad del sujeto y sin superposiciones de depuración.

Individual skills in this repo

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

sansayan01/finance_app_zo

Add captions to a talking-head video. ONE catalog (CATALOG.md) of 36 visual identities behind two engines: column-flow (captions composited INTO the scene — matte occlusion + mix-blend; cream/ink/editorial/keynote/documentary/loud/neon/glitch/chrome/velocity) and themed constitutions (anchor/ordnance/terminal/neonsign/stardust/stomp/scoreboard/transit/vhs/arcade/dossier/laser/thunder/hologram/biolume/aurora/spectrum/papercut/popup/chalkboard/graffiti/brush/inkwater/ransom/lastpage/nightcity — e.g. a glyph-decode climax, a neon sign WRITTEN stroke by stroke, or the quiet `anchor` rail default). Route by identity, never by mode. Trigger on "captions/subtitles", "embed/cinematic captions", "VFX captions", "炸/特效/酷炫字幕", a named identity, or top-tier motion-graphics asks. Embedding every word is wrong for most talking-head content — `anchor` is the verbatim default. Runs locally end-to-end (transcribes and mattes the subject itself, no API key). Requires hyperframes and a single-subject clip (multi-shot clips ar...

sansayan01/finance_app_zo

The fallback workflow for authoring or editing any custom HyperFrames composition at any length or format — longer / multi-scene pieces, brand and sizzle reels, montages, title cards, static loops, freeform builds. Use only when no specialized workflow fits the input; routing table at /hyperframes.

sansayan01/finance_app_zo

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

sansayan01/finance_app_zo

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, render, publish, cloud, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, tts, or remove-background (validate/inspect/layout are deprecated aliases covered by check), or when troubleshooting the HyperFrames build/render environment. Entry point for HeyGen-hosted cloud rendering (`hyperframes cloud render / list / get / delete`) and self-managed AWS Lambda rendering (`hyperframes lambda deploy / render / progress / destroy / policies / sites`).

sansayan01/finance_app_zo

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition HTML.

sansayan01/finance_app_zo

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

sansayan01/finance_app_zo

MicroFlow Pro - MFI Staff Portal built with Flutter & Supabase

Skills relacionados