Construcción de una animación individual
Construyes una animación completa de 4 a 10 segundos que se integra en el video como una inserción o se superpone sobre el cuadro. Debe mostrar visualmente la idea que el autor expresa con su voz — no ilustrar en general, sino mostrar específicamente esa idea.
Estilo predeterminado: v4 «presentación con imágenes»
Si el usuario no pide otra cosa, construye en estilo v4. El autor lo llamó «absolutamente ideal» y pidió que los siguientes videos sean exactamente iguales. Todo sobre él está en references/style-v4.md: referencias (descripciones en references/style-v4.md), diseños kinetic / full / split-cam / split-screen / lower con geometría precisa, constantes, sonido, aceptación.
- Estilos y ayudantes generales:
assets/style-v4/common.css,common.js(heroIn,rise,chipIn,countUp). - Escenas de referencia (fragmentos +
.sfx.json):references/recipes/v4/— comienza con el diseño más cercano. - Construcción: escribes el fragmento
W/scenes/NN.html→python3 scripts/mk_scene.py W NN→check→ render. Imágenes:scripts/gen_images.sh+scripts/alpha.py; clips de webcam/pantalla:scripts/cut_clips.py. - Sonidos de sello y «resultado negativo»:
assets/style-v4/sfx/, el resto es el paquete media-use.
Capa antigua (abajo): las técnicas están tomadas de la edición de Austin Marchese y adaptadas al sistema de diseño del canal: morphing PiP, zoom-through, carrusel de capítulos, etc. En v4 se usan como acentos dentro de la escena, no como base. Las técnicas se copian exactamente: tiempos, curvas, orden de capas; la paleta y la tipografía son solo del sistema propio.
Qué leer y en qué orden
references/style-v4.md— cómo debe verse.references/gotchas.md— antes de escribir código. Allí están las prohibiciones del motor, las trampas del tema claro y las reglas de las uniones. Cada punto ha costado una iteración.references/style-rules.md— leyes de estilo: cómo aparece y desaparece el texto, qué marca el ritmo, qué se mueve siempre. Respétalas independientemente de la técnica que estés construyendo; son las que hacen reconocible la edición.references/design-system.md— paleta, escalas, componentes, reglas de marca. No se pueden violar.- Mecánica de tu técnica — lee solo tu sección:
references/techniques.md— técnicas con implementación probada;references/techniques-observed.md— técnicas extraídas del análisis pero aún no construidas; constrúyelas según la descripción.
references/recipes/<técnica>.html— implementación funcional detechniques.md. No es una plantilla para copiar completa, sino un ejemplo de cómo se resolvieron las partes complejas. Consúltalo cuando la mecánica no sea obvia.
La especificación de la escena concreta llega desde /motion-plan o directamente del usuario.
Orden de trabajo
1. Prepara el proyecto
Si el proyecto aún no existe:
./node_modules/.bin/hyperframes init <nombre> --example blank --non-interactive --resolution landscape --skill motion-graphics
Un npx hyperframes simple en la raíz del repositorio falla con «Missing script» — el CLI no es global. Dentro de un proyecto ya creado funcionan npm run check y npm run render; fuera, se usa la ruta al binario indicada arriba.
Copia la carpeta assets/ de este skill completa al proyecto, no archivo por archivo: tokens.css carga fuentes mediante @import "./fonts/fonts.css", y la estructura de directorios debe coincidir.
cp -R <ruta-al-skill>/assets/. <proyecto>/assets/
Las fuentes Onest y Unbounded están almacenadas localmente (cirílico y latino), por lo que el texto se renderiza igual en cualquier máquina. GSAP, la plantilla de inicio y todas las recetas se cargan desde CDN — se necesita red en el render. Si no hay red, coloca gsap.min.js cerca y corrige <script src>.
Conexión de tokens en la composición — una sola línea:
<link rel="stylesheet" href="./assets/tokens.css" />
2. Construye la composición
Contrato de HyperFrames: un único paused-timeline en window.__timelines["main"], cada elemento timed con class="clip", data-start y data-duration. Detalles en /hyperframes-core, cárgalo si dudas de la estructura.
Tres cosas que determinan si la técnica funciona o no:
Copia los tiempos y curvas literalmente. La diferencia entre power2.inOut y power2.out en el crecimiento de PiP es la diferencia entre un movimiento de cámara y un escalado de imagen. La diferencia entre power3.inOut y power4.inOut en una unión push es la diferencia entre un desplazamiento y un tirón.
Mantén la técnica, no la letra de la especificación. Si la descomposición fotograma a fotograma de la especificación difiere del easing declarado (los porcentajes de crecimiento no coinciden con la curva), la prioridad es el easing: él determina cómo se lee el movimiento. Si la especificación da una amplitud con la que el objeto no sale del cuadro al final del clip, recalcula la amplitud según la geometría real 1920×1080 e indícalo.
Si la técnica no se percibe, hay que reforzarla. Una implementación formalmente correcta pero invisible no es trabajo terminado. Una transición de relleno sobre fondo claro es casi invisible hasta que se añade un marcador de frente. Una unión donde ambos lados están vacíos no tiene nada que mostrar.
Si la técnica no está ni en techniques.md ni en techniques-observed.md — constrúyela según la descomposición fotograma a fotograma de la especificación, pero primero encuentra en ella el punto de inflexión: la decisión de la que depende que el fotograma funcione o no. Normalmente no es una curva sino la geometría — cuánto desplazar, dónde está el centro del grupo, qué sale del borde. La especificación la escribe quien no ha visto los fotogramas; probablemente no notó el punto de inflexión. Toma la decisión tú mismo, verifícala con los fotogramas y nómbrala obligatoriamente en el informe — pasará al skill del siguiente.
3. Verifica
npm run check
Cero errores y cero advertencias. La auditoría de contraste y diseño se quejará de las propias técnicas — fondo borroso, superposición de escenas en la unión, vecinos atenuados. Distingue la técnica del problema real: arregla los hallazgos reales, las técnicas márcalas con los opt-outs estándar. Cada opt-out silencia exactamente su verificación — la tabla está en gotchas.md, no se puede colocar al azar: data-layout-ignore desactiva también el contraste, y el texto debajo queda fuera del informe sin aviso.
Además, coloca junto al archivo un sidecar *.motion.json — check lo recoge automáticamente y verifica la intención de movimiento en el mismo timeline rebobinado que usa el render. Es el análogo automático más cercano a «renderiza y mira»: detecta una entrada que el rebobinado saltó, un orden de stagger roto y un plano congelado. El formato está en gotchas.md.
4. Míralo con tus ojos — este paso es obligatorio
../node_modules/.bin/hyperframes snapshot . --frames 8 -o snapshots
Abre snapshots/contact-sheet.jpg a través de Read — es una imagen, la ves. check no te dirá que el fotograma está vacío, el texto es pequeño o los bloques están desordenados.
Mira el fotograma 0 por separado — es el fallo más común. Según las leyes de estilo, la escena comienza ya en movimiento, no desde la estática ni desde el vacío; si en el fotograma cero está vacío o todo está ensamblado, la técnica está rota en el lugar más visible.
Además, toma fotogramas puntuales en los puntos más complejos:
../node_modules/.bin/hyperframes snapshot . --at 1.45,1.55,1.675,1.8 --no-end -o snapshots-detail
Qué puntos elegir: si la técnica tiene una unión — el centro de la unión y un fotograma a cada lado. Si no hay unión, toma los momentos de recálculo de la composición: compresión de lista, reordenación de bloque, cambio de elemento activo. Es allí donde el diseño se rompe, y en ocho fotogramas uniformes no se ve.
Los lugares dudosos (degradados, tamaño de letra pequeño) míralos en PNG a tamaño completo: el JPEG de la hoja de contacto miente tanto en tamaño como en bandas.
Itera hasta que la imagen sea buena. La primera versión casi siempre sale pequeña — es el error más común, el fotograma 1920×1080 es más grande de lo que parece.
5. Renderiza
npm run render
Dónde colocar el MP4
En renders/ de tu proyecto y en ningún otro lugar. Nombra la ruta del archivo en el informe; quien ensambla el video completo distribuirá las inserciones terminadas en las carpetas comunes porque solo él sabe cómo se llaman en la línea de tiempo y cuáles están aceptadas.
No es una formalidad. En un video, nueve ensambladores colocaron el resultado en tres lugares diferentes, dos eliminaron renders/ por completo, uno duplicó el archivo en dos carpetas «para que el orquestador lo encuentre de todas formas» — y el orquestador tuvo que buscar los renders con find por todo el disco. La regla sobre «videos finales en output/» de CLAUDE.md se refiere a videos terminados, no a inserciones para ensamblaje: una inserción es un producto semielaborado.
La carpeta de trabajo del proyecto tampoco la elimines. El orquestador la borrará cuando la escena esté aceptada; hasta entonces puede ser necesaria para correcciones.
Overlay sobre el cuadro: incrusta la base en la composición
Un overlay — panel de vidrio, título, glosario — está diseñado para un fotograma específico debajo y tiene una consecuencia técnica no evidente: backdrop-filter no ve lo que no está en la composición. Si renderizas el overlay sobre fondo transparente y lo superpones en el programa de edición, el vidrio difuminará el vacío, es decir, no difuminará nada, y el panel quedará como una película plana.
Por eso la composición del overlay se construye de manera diferente a la inserción:
# un fragmento del original exactamente en el timecode de la escena — en assets del proyecto
ffmpeg -ss 20.0 -i <original> -t 4.0 -vf "scale=1920:1080,fps=30" -an \
-c:v libx264 -crf 16 -preset veryfast -pix_fmt yuv420p -y assets/plate.mp4
<video id="plate" class="clip" data-start="0" data-duration="4" data-track-index="0"
src="./assets/plate.mp4" muted data-layout-ignore></video>
La base va en la pista cero y se marca con data-layout-ignore — no se audita. El vidrio sobre ella funciona de verdad. A la salida es un MP4 normal que en la edición se coloca en lugar de su fragmento, no sobre él; el sonido de la base se ha extraído, la pista se toma del original.
Alternativa: --format mov con transparencia — solo es necesaria cuando el editor pide explícitamente alfa y está dispuesto a colocar la capa él mismo.
Qué informar
Brevemente, 10 a 15 líneas: qué resultó, ruta al MP4, qué lugares resultaron difíciles y cómo se resolvieron, qué quedó imperfecto. No repitas el código — está en el archivo.
Nombra por separado las discrepancias con la especificación. Si recalculaste la amplitud, cambiaste la curva o añadiste un elemento que no estaba en la especificación, dilo y explica por qué. La especificación la escribe quien no ha visto los fotogramas; tú los has visto. Una discrepancia que se comunica es un hallazgo; una que se omite es una sorpresa en el montaje.
Qué se considera terminado
checklimpio, MP4 renderizado;- la técnica se percibe en los fotogramas a simple vista, no solo «implementada formalmente»;
- se respetan la paleta, las escalas y las reglas del sistema de diseño;
- determinismo: dos capturas del mismo timecode dan el mismo SHA-256 si hay pseudoaleatoriedad en la escena.