Communitygithub.com

AlessandroFare/fluxychat

PUERTA DE ENLACE — cárgala PRIMERO antes de componer cualquier animación o video HyperFrames. La ley de movimiento de alto nivel que hace que un video de múltiples escenas se sienta como UN SOLO movimiento de cámara continuo, en lugar de una pila de diapositivas animadas independientemente.

¿Qué es fluxychat?

Este skill, llamado Motion Doctrine (Gateway), establece la ley de movimiento fundamental que debe aplicarse antes de crear cualquier animación en HyperFrames. Su propósito es garantizar que las transiciones entre escenas sean fluidas y coherentes, evitando que el ojo del espectador pierda impulso en cada corte. Define reglas estrictas sobre vectores de movimiento, velocidad, dirección y fase para que cada escena se comporte como parte de un único movimiento de cámara continuo. Incluye conceptos clave como la Ley Vectorial (cómo una escena sale determina cómo entra la siguiente), la Corriente (dirección dominante del film), Portadores (elementos visuales que guían el ojo a través de los cortes), Movimiento Causal (cada movimiento debe ser lanzado por el anterior), y la Puerta de Costura (verificador numérico que asegura el cumplimiento de las reglas). También prohíbe el movimiento inactivo (wobble) y establece rutas de movimiento sostenido. Los skills técnicos como 'cut-the-curve', 'oversized-cursor' y 'seam-craft' implementan estas decisiones. El skill es compatible con HyperFrames y utiliza un ledger JSON para planificar las costuras, scripts de verificación y marcas de tiempo de audio como reloj maestro.

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

Preguntar en tu IA favorita

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

Documentación

Doctrina de Movimiento (Puerta de Enlace)

Lee esto antes de componer cualquier animación. Decide QUÉ sucede en cada costura y cómo se desempeña cada escena; los skills de técnica lo implementan. Estas reglas reemplazan cualquier guía de movimiento genérica / upstream. El fallo que previene: escenas creadas de forma aislada — el impulso del ojo muere en cada corte, y las escenas se tambalean en su lugar entre la entrada y la salida.

Mapa de rutas

Decisión (este skill)Skill de implementación
Elección de transición de costura + parámetros + códigocut-the-curve §1–5 (el catálogo)
Cascadas de entrada de texto / elementocut-the-curve §6 (entrada en cascada)
Reposicionamiento de grupo dentro de la escena (sin corte)cut-the-curve §7 (curva de empuje)
Acción liderada por cursor / inicio de escena / ignición de morphoversized-cursor
Mecánicas de renderizado de costura / protección de destello blancoseam-craft
Trabajo de lanzamiento de producto / explicador / subtítulossuperpone text-beat-economics, brand-faithful, captions-overlay sobre el skill upstream

Orden de creación: ledger vectorial (ledger.json) → SELLAR las costuras maestras desde él (scripts/seam-stamp.mjs --ledger ledger.json --write index.html) → ruta de movimiento sostenido por fase → portadores y causas → construir composiciones → VERIFICAR (scripts/seam-gate.mjs). Solo crear a mano morphs / match-cuts de nivel A; las costuras selladas pasan la puerta por construcción.


Parte 1 — La Ley de la Costura

La Ley Vectorial

Cómo la Escena A sale determina cómo la Escena B entra: mismo eje, misma dirección, velocidad coincidente, corte en medio del movimiento en ambos lados.

  1. Eje — x se queda x, y se queda y, Z se queda Z. Nunca intercambiar ejes en un corte.
  2. Dirección — nunca reflejar. En Z, dirección = el SIGNO del cambio de escala: crecer = empuje (cámara hacia adelante), encoger = tirón (cámara hacia atrás). Una salida que retrocede respondida por una entrada que crece desde pequeño es un vector reflejado — la violación más común, porque crecer desde pequeño es la entrada de elemento por defecto.
  3. Velocidad — velocidad inicial de entrada ≈ velocidad final de salida, mediante suavizados reflejados (salida power4.in + entrada power4.out, misma distancia y duración; el lado entrante recoge ≥50% a través del camino nocional). Mecánica en cut-the-curve.
  4. Fase — el corte aterriza en medio del movimiento en AMBOS lados. Calmarse hasta el reposo antes del corte, o comenzar desde el reposo después, es un latido muerto.

La Corriente

Cada película elige UNA dirección dominante (valor por defecto de la casa: IZQUIERDA). Cada costura ordinaria la usa. Otros vectores están RESERVADOS — gastar uno significa algo:

VectorSignificado
La corriente (IZQUIERDA)"siguiente latido" — progreso neutral hacia adelante
Hacia arribaelevación — una conclusión o revelación se eleva sobre lo que vino antes
Z hacia adelante (zoom a través)empujar más profundo en el mismo pensamiento
Z hacia atrás (zoom inverso)LLEGADA — algo más grande aterriza
Explosión de escala (explotar hacia afuera)salir de un mundo — una superficie explota más allá de la cámara
  • Nunca ejecutar costuras consecutivas en direcciones opuestas — el ping-pong se lee como un error.
  • Un cambio de dirección necesita una causa visible (clic / rebote / impacto) o un límite de capítulo.

El Ledger Vectorial

Escríbelo antes de crear cualquier línea de tiempo maestra — como ledger.json en la raíz del proyecto (esquema: references/seam-gate.md). Una fila por costura: tiempo de corte, vectores de salida y entrada (eje + dirección con signo; las filas Z llevan el signo de escala), selectores, técnica. La salida y la entrada deben coincidir; si una fila no coincide, corrige el plan, no el suavizado. El verificador comprueba la consistencia de las filas de forma estática antes de cualquier muestreo en tiempo de ejecución.

Portadores

El ojo sigue objetos, no abstracciones. Las costuras más fuertes entregan un portador concreto a través del corte en una posición Y velocidad coincidentes: un cursor a medio camino, un contenedor que se encoge/acopla en el siguiente diseño, una marca que vuela a su ranura exacta, el grupo de palabras de un corte en cascada. Sin portador natural, los héroes de la escena lo llevan (viaje parcial + fundido temprano, entrada en pleno vuelo). Nunca un fundido cruzado — no tiene ningún portador.

Movimiento Causal

Encadena el movimiento para que cada movimiento sea visiblemente lanzado por el anterior: clic → apretar → liberar resorte → vuelo → impacto → retroceso → revelación.

  • Los efectos comienzan EN el fotograma causante — misma posición en la línea de tiempo, nunca "poco después".
  • Las reacciones escalan con la masa implícita: los elementos grandes rebotan más lento, los pequeños más rápido.
  • Una fuerza es una licencia para cambiar de dirección; un giro sin causa es un ping-pong.

La Puerta de Costura (puerta de construcción — ejecuta el verificador, salida 0 o la costura no está terminada)

node <SKILL_DIR>/scripts/seam-stamp.mjs --ledger ledger.json --write index.html  # generar
node <SKILL_DIR>/scripts/seam-gate.mjs  verify --ledger ledger.json --project .  # verificar

El script (uso + esquema del ledger: references/seam-gate.md) aplica numéricamente, por costura: consistencia de la fila del ledger, salida todavía en movimiento en el corte, entrada en pleno vuelo (nunca desde reposo), dirección medida = dirección del ledger, coincidencia de velocidad de entrada/salida (ADVERTENCIA), sin superposición (un lado visible por fotograma — el corte no es un fundido), la regla del SIGNO Z (d(scale)/dt mismo signo en ambos lados; las propias entradas de la escena entrante se escanean en busca de lucha de signos), y continuidad del rectángulo portador con escala ascendente incluida. Usa seam-gate.mjs probe --t <cut> para encontrar los verdaderos selectores de portador de cada costura al crear el ledger.

Reglas que el script no puede verificar — aún tuyas:

  1. Ediciones reabren la costura. Cualquier cambio en el primer/último ~1s de una escena (incluyendo re-timing para nueva VO) invalida la auditoría de ese límite — vuelve a ejecutar el verificador.
  2. El audio es el reloj. Re-temporiza las escenas a las marcas de tiempo reales de la VO; nunca apresures una lectura para que encaje en un espacio. Una regeneración de VO reabre sus costuras.
  3. Problema de clip-gating (la causa habitual de un FALLO de superposición cero): un clip cuyo data-start precede a su tweener de entrada está descubierto en su opacidad inicial — establece autoAlpha: 0 inicial Y data-start = el tiempo de corte, nunca antes.

Parte 2 — Rendimiento (la escena sigue funcionando)

Sin bamboleo inactivo

Los bucles de seno inactivos (respirar, flotar, derivar, pulso de brillo) están PROHIBIDOS como movimiento sostenido — se leen como "el video está esperando". Una escena que termina de entrar con segundos restantes es un error de planificación: añade historia, no bamboleo. Cada fase entre la entrada y la salida es propiedad de una de estas rutas (nombra la ruta en el plan):

RutaQué es
Revelaciones escalonadasRetén contenido; entrégalo en los latidos de la narración — el fotograma sigue ganando información (predeterminado para ≥2 grupos de contenido)
Cámara con intenciónUna ruta de escala+pan mapeada: establecer amplio → viajar → llegar al sujeto
Vida de UI secuenciadaEl producto se comporta en el tiempo: el progreso avanza, se resalta el paso, los contadores marcan
Secuencias animadasLos elementos representan un latido: una tarjeta se archiva en una pila, un elemento se arrastra, un resultado se ensambla
Acción liderada por cursorUn cursor de gran tamaño camina el ojo hasta un desencadenante; su CLIC enciende el siguiente latido (oversized-cursor)

Prueba: pausa en cualquier segundo — algo significativo debe estar en pleno vuelo (una revelación aterrizando, la cámara viajando, la UI haciendo lo que dice la narración).

Quietud antes del clímax

Programa una pausa de 0.3–0.75s entre la acción principal y su resultado — la coma dramática. Una escena que salta directamente de la acción al resultado lo pierde.

Intenciones de temporización

  • Una entrada única ≤ ~800ms; una construcción más larga = escalonamiento de múltiples elementos, no un elemento lento.
  • Salida ≈ 75% de la entrada. Excepción: cut-the-curve invierte esto (entrada ~127% de la salida).
  • Escalonamiento total ≤ 500ms; con 8+ elementos, aprieta el retardo por elemento o escalona los primeros.
  • Suavizados prohibidos: bounce.out / elastic.out. El rebasamiento back.out(1.4–1.7) de entrada está bien.
  • Elementos similares comparten una intención de suavizado+duración — nunca un par único por elemento.

Vocabulario de transición

Usa solo 2–3 transiciones entre escenas por película y repítelas; el límite predeterminado es cut-the-curve en la dirección de la corriente. Los morphs de elemento compartido escritos a mano (intent: morph) no cuentan para el presupuesto.


Anti-Patrones

No hagasEn su lugar
Crear la entrada de cada escena de forma aisladaEscribe primero el ledger vectorial
Fundido cruzado entre escenasCut-the-curve en la dirección de la corriente
La salida se completa, LUEGO la escena cambiaCorta en medio del movimiento en ambos lados
La entrada comienza desde reposo después de un corteEntra ≥50% a través del camino nocional
Salida de zoom inverso → entrada que crece desde pequeño (o empuje → retracción sobredimensionada)Coincide el signo de velocidad de escala (Puerta de Costura 7)
Introducción de pop-in de la propia escena entrante bajo una transferencia de costura ZMantén su fotograma de apertura compuesto, o coincide el signo
Bamboleo inactivo / respirar / flotar para llenar tiempoAsigna una ruta de movimiento sostenido; o añade historia
Giro de dirección sin una causaGasta una fuerza, o mantén la corriente
Vectores reservados usados como variedadPor defecto usa la corriente; gástalos en significado
Reacción unos fotogramas después de su causaEncendido en el mismo fotograma
La acción salta directamente al resultadoPrograma quietud antes del clímax (0.3–0.75s)

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

Use when a HyperFrames composition needs seek-safe 2D/3D keyframes, GSAP timelines, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw, text trails, 3D depth, or `hyperframes keyframes` diagnostics. Don't use for broad scene strategy, brand design, media sourcing, captions, or general video planning.

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