Communitygithub.com

AlessandroFare/fluxychat

Úsalo cuando una composición HyperFrames necesite keyframes 2D/3D seguros para búsqueda, líneas de tiempo GSAP, keyframes CSS, Anime.js, WAAPI, FLIP, trazados, máscaras, morph/dibujo SVG, estelas de texto, profundidad 3D o diagnósticos `hyperframes keyframes`.

¿Qué es fluxychat?

Este skill, HyperFrames Keyframes, define un contrato estricto para la creación de keyframes (fotogramas clave) en composiciones de HyperFrames. Su propósito es garantizar que las animaciones sean seguras para la búsqueda (seek-safe), mantengan la identidad continua del sujeto y verifiquen píxel a píxel el resultado final. El skill detalla un procedimiento paso a paso que va desde la identificación del sujeto animado y sus estados visibles hasta la verificación con herramientas CLI como `hyperframes lint` y `hyperframes keyframes`. Es compatible con múltiples motores de animación (GSAP, Anime.js, WAAPI, CSS keyframes) y tecnologías como SVG, Canvas, WebGL y 3D DOM, proporcionando reglas de ejecución específicas para cada uno. Además, incluye guías para elegir el mecanismo de animación más pequeño y adecuado para cada necesidad (como FLIP para cambios de caja o trazados para rutas visibles), normas de temporización, manejo de errores y un flujo de verificación final para asegurar que la animación cumple con el contrato establecido.

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

Preguntar en tu IA favorita

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

Documentación

HyperFrames Keyframes

Los keyframes son un contrato de pose: estados visibles, identidad continua del sujeto, tiempo de ejecución seguro para búsqueda, píxeles verificados.

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

Procedimiento

  1. Identifica el sujeto animado, los estados visibles, el estado final y el tiempo de ejecución.
  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 seguros para búsqueda en el tiempo de ejecución declarado. Construye de forma síncrona y registra la instancia de tiempo de ejecución.
  4. Verifica con hyperframes lint, hyperframes check, hyperframes keyframes, un --shot enfocado y capturas en los momentos 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 probar el movimiento previsto, incluido el estado final.
  • Keyframe en canales visibles, no en estados auxiliares ocultos.
  • Preserva la identidad del objeto cuando la continuidad sea importante.
  • Funde solo cuando el movimiento previsto sea reemplazo o disolución.
  • Mantén los estados legibles o semánticos el tiempo suficiente para ser vistos.
  • El fotograma final es parte de la animación, no una limpieza.
  • No reinicies a un estado de reposo a menos que se solicite.
  • No termines en negro a menos que se solicite.
  • Si editas una escena inicial, preserva el diseño, el texto, los activos, los colores y el estado final a menos que se te pida rediseñar.

Reglas de tiempo de ejecución

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 renderizado
  • Mantén las repeticiones finitas

Keyframes CSS:

  • Duración finita y número de iteraciones
  • Retraso determinista
  • animation-fill-mode: both
  • Usa data-start cuando la sincronización pertenezca a un clip

Anime.js:

  • Crea de forma síncrona
  • autoplay: false
  • Duración finita y bucles
  • 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

Nunca uses para movimientos críticos de renderizado:

  • Date.now()
  • performance.now()
  • Math.random() sin semilla
  • Disparadores de hover/scroll
  • Temporizadores
  • Líneas de tiempo creadas asíncronamente
  • 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 retrasos encadenados. Usa immediateRender: false para interpolaciones from()/fromTo() posteriores que toquen la misma propiedad.

Formas de keyframes

  • Array de keyframes: escalera de poses con duración/ease por paso.
  • Keyframes porcentuales: sincronización exacta dentro de una interpolación.
  • Arrays de propiedades: cambios compactos de múltiples paradas.
  • ease: "none" en el padre cuando cada parada tenga su propia suavización.
  • easeEach cuando cada segmento deba compartir la misma sensación.

No copies distancias numéricas ni tiempos de los ejemplos. Deducirlos de la geometría y duración real 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 múltiples keyframes suavizados solo cuando el espectador deba sentir tiempos distintos; cada segmento cambia la velocidad y puede leerse como un tropiezo.

Canales

Prefiere canales de composición/visuales: x/y/z, xPercent/yPercent, scale, rotationX/Y/Z, skew, transformOrigin, svgOrigin, opacity, autoAlpha, clip-path, máscaras, variables CSS, valores de ruta/trazado SVG, transformaciones de cámara, uniformes 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 hagan el movimiento del sujeto.

Para cambios de visibilidad, usa autoAlpha en la línea de tiempo GSAP registrada y buscable, o un tl.set() de duración cero en un límite explícito. Apunta solo a un elemento que no sea un clip o a un contenedor dentro del clip; nunca apuntes al propio .clip. Nunca interpoles duración en visibility crudo, y nunca interpoles display.

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 visiblerecorrido de trazado
Un trazo crece o trazadibujo de trazo
Una forma se convierte en otrainterpolación de forma
El límite de revelado es visibleclip, máscara o uniforme de shader
Muchos elementos se mueven con ordenescalonado / índice de retraso
El texto en sí se muevesubdivisión de línea, palabra, carácter o banda
Una superficie se dobla, estira o recortacontratransformación padre/hijo
La interfaz de usuario tiene estadosmáquina de estados explícita
La escena tiene profundidadkeyframes 3D DOM, Three.js o WebGL de cámara/objeto

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

Sincronización

  • Anticipación solo cuando aclare la causa o dirección.
  • La aceleración sale del reposo.
  • El pico de prueba muestra el mecanismo de forma inequívoca.
  • El seguimiento vende energía y dirección.
  • Sobreimpulso solo cuando el sujeto deba sentirse elástico o táctil.
  • El recorrido de trazado a velocidad constante generalmente necesita ease: "none".
  • Los estados discretos de interfaz de usuario generalmente necesitan un ease-out pronunciado.
  • Los elementos repetidos necesitan desplazamientos ordenados, no sincronización idéntica.
  • Los bloqueos finales necesitan retenciones 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 verificada.
  • Evita animar grandes cambios de clip-path/máscara mientras la misma superficie principal también se está escalando o desplazando; usa revelaciones anidadas después de que el movimiento principal se asiente.

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 de trazos prefiere DrawSVGPlugin, luego stroke-dasharray/stroke-dashoffset. Para la interpolación de formas prefiere MorphSVGPlugin; convierte primitivas a trazados 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, desplazamiento 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 angulada no muestra cruce de profundidad, mejora el movimiento z/cámara/oclusión.

Canvas / 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 uniformes 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 canvas.

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 "<archivo>" --samples <n>
npx hyperframes keyframes . --selector "<selector>" --shot "<archivo>" --layout strip --from <t0> --to <t1>
npx hyperframes keyframes . --shot "<archivo>" --ghost --angle <ángulo>
npx hyperframes snapshot . --at <tiempos>

Elige <selector> para el sujeto animado real. Elige <tiempos> para el primer fotograma, las poses de prueba, el final menos la retención y el final exacto. Elige <ángulo> solo cuando la profundidad deba probarse.

HerramientaPrueba
keyframesobjetivos, paradas explícitas, trazados, trazas, movimiento compuesto padre/hijo, paradas CSS, registro de Anime
--shotfantasmas, forma de la ruta, espaciado temporal, proyección 3D DOM, prueba de selector enfocado
--layout stripmovimiento in situ, superposiciones, contacto, escala/opacidad sutiles, ondas de texto
--ghostcanvas, WebGL, movimiento de shader, 3D renderizado
snapshot --atmáscaras, legibilidad del texto, estado completo, bloqueo final, colas en negro/reinicio

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ósticos

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.

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

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

Manejo de errores

FallaSolución
solo punto finalañade poses intermedias, mantén el pico de prueba, vuelve a ejecutar --shot
rotura de identidadmantén un elemento vivo, usa cajas de origen/destino compartidas, elimina el fundido de sustitución
3D falsoañade desplazamiento z/cámara, oclusión, prueba angulada
final incorrectoañade retención final, captura el final menos la retención y el final exacto
tiempo de ejecución 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 retención final, captura fotogramas de texto

Terminado

Ejecuta hyperframes lint, hyperframes check, hyperframes keyframes, un --shot enfocado y capturas. Confirma el primer fotograma, las poses de prueba, el final menos la retención, el final exacto, el movimiento propiedad del sujeto y que no haya superposiciones de depuración.

Individual skills in this repo

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

AlessandroFare/fluxychat

Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet `anchor` rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.\n

AlessandroFare/fluxychat

Use when audio already placed in a HyperFrames composition needs to be mixed: a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), or automation envelopes drawn on a track's volume or any effect parameter. Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.\n

AlessandroFare/fluxychat

Use the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, cloudrun, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, auth, tts, and remove-background. Also use when diagnosing build or render failures. validate, inspect, and layout are deprecated aliases; use check. Covers local, HeyGen-hosted cloud, AWS Lambda, and Google Cloud Run rendering.\n

AlessandroFare/fluxychat

Install, discover, and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add or hyperframes catalog, installing one item or every block matching a tag, wiring an installed item into index.html, or working with hyperframes.json. Covers discovery, install locations, block sub-composition wiring, component snippet merging, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

AlessandroFare/fluxychat

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.\n

AlessandroFare/fluxychat

Overlay doctrine for the embedded-captions workflow — the caption MODEL (drop / rail / embed) and the rule that captions are an OVERLAY composited on top of the film, never a reserved bottom band you shift content up to avoid. Load when adding captions/subtitles to a talking-head or launch video, when deciding whether a phrase should be dropped, ride the verbatim rail, or be promoted to a scarce embedded climax, when laying out a composition that will carry captions (do NOT reserve a keep-out band), or when centering a composition on the true frame center under captions. Quotes the rail+embed model from embedded-captions and constraint #13 (captions overlay, keep-out band retired) from the product-launch-video scene agent. Applies ON TOP of embedded-captions.

AlessandroFare/fluxychat

Turn a weekly changelog .md into a finished branded changelog video (square 1080, ~45-60s, Annie VO, animated brand background, mock-UI visualizations, lowkey captions). Use when the user provides a changelog/digest markdown and wants the weekly video, or says "changelog video". Self-contained — fonts, background, lexicon, and scripts ship in this skill.

AlessandroFare/fluxychat

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

AlessandroFare/fluxychat

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

AlessandroFare/fluxychat

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.

AlessandroFare/fluxychat

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.

AlessandroFare/fluxychat

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

AlessandroFare/fluxychat

GATEWAY — load FIRST before composing any HyperFrames animation or video. The high-level motion law that makes a multi-scene video feel like ONE continuous camera move instead of a stack of independently-animated slides. Covers the vector law (how you exit determines how you enter, incl. the Z scale-sign rule), the film's current, carrier elements, causal motion, the Seam Gate (build-gate enforcement), the ban on idle wobble (motion must PERFORM, not breathe), stillness-before-climax, and the sustained-motion routes. Routes to the low-level technique skills (cut-the-curve — the full catalog incl. waterfall entry + nudge curve, oversized-cursor, seam-craft). These rules SUPERSEDE generic / upstream motion guidance. [continuity, direction, vector, momentum, seam, transition, ease, performance, idle-motion, narrative-motion, film-grammar]

AlessandroFare/fluxychat

A short, design-led motion graphic where motion is the message — kinetic typography, stat count-up, chart/data-viz hit, logo sting / brand lockup, lower-third / callout / social overlay, animated map (highlight regions, connect places, zoom to a location), animated tweet / news-article / headline, webpage / UI animation (scroll, cursor, callouts), or fusing a real image's geometry into a chart. Usually under 10s (up to ~30s), no narration or live-action subject; renders to MP4 or transparent overlay. Longer / narrated / multi-scene → /general-video. Unclear → /hyperframes.

AlessandroFare/fluxychat

Turn a music track (an audio file, a video to pull audio from, or a track generated from a mood brief) into a beat-synced video — lyric video, slideshow, or kinetic promo. The music drives all pacing; any user-supplied images/videos are cut onto the same beat grid, and a complete video needs zero assets. Narrated pieces → the input-matched workflow (see /hyperframes). Unclear → /hyperframes.

AlessandroFare/fluxychat

Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.

AlessandroFare/fluxychat

Turn a GitHub pull request (a PR URL, owner/repo#N, or 'this PR' in a checked-out repo) into a code-change explainer video — changelog, feature reveal, fix, or refactor walkthrough built from the diff, commits, and files: the input is a code change, not a website. Not a product promo (/product-launch-video) or a no-PR topic explainer (/faceless-explainer). Unclear → /hyperframes.

AlessandroFare/fluxychat

Design and improve user interfaces using the concrete rules from Refactoring UI (Wathan & Schoger) — constrained spacing/type/color/shadow scales, visual hierarchy through weight and color rather than size, and depth through emulated light. Use when building or styling any UI (web, app, dashboard, landing page, component), when picking font sizes, spacing, colors, shadows or border radius, when designing a color palette or design tokens, and whenever someone says a UI "looks off", "looks amateur", "feels cluttered/plain/unfinished", or asks to "make this look better".

AlessandroFare/fluxychat

Port an existing Remotion (React) composition''s source to HyperFrames HTML. Use ONLY on an explicit ask to port/convert/migrate/translate a Remotion source — one-way, Remotion-only. A passing Remotion mention, reference-only code, or "make something like my Remotion video" is a fresh build (/general-video). Unclear → /hyperframes.

AlessandroFare/fluxychat

Use before UI-related work to select the smallest useful UI Skills context through the ui-skills CLI.

Skills relacionados