Communitygithub.com

cskwork/motion-graphics-skill

Crea videos de gráficos en movimiento generados por código a partir de HTML, precisos por fotograma y reproducibles. Formatos: videos de lanzamiento, anuncios o cortos verticales (YouTube Shorts, Reels o TikTok).

¿Qué es motion-graphics-skill?

Esta habilidad permite generar videos de gráficos en movimiento de alta calidad, similares a los de un estudio profesional de motion graphics, directamente desde código HTML. Cada video es una página HTML donde cada píxel es una función pura del tiempo `t`, renderizada fotograma a fotograma en un Chromium sin interfaz gráfica y codificada con ffmpeg. El resultado rivaliza con el reel de un diseñador senior de motion graphics, nunca con una simple presentación de diapositivas. La habilidad soporta dos formatos principales: videos de lanzamiento (estilo keynote de Apple o Google, lanzamientos SaaS en X) y cortos verticales (YouTube Shorts, Reels, TikTok) con enfoque en el gancho inicial y bucles. Incluye una biblioteca de funciones auxiliares (MG.*) para escenas, animaciones, interpolaciones, división de texto y ruido determinista, garantizando reproducibilidad sin usar Date, performance.now() o Math.random. El flujo de trabajo guía al usuario desde la creación de la carpeta de trabajo, la composición con HTML y CSS, el renderizado con workers paralelos, la mezcla de audio con ffmpeg (buscando -14 LUFS) hasta un riguroso QA con fotogramas de verificación y hoja de contacto. Es ideal para desarrolladores y creadores que necesitan producir videos promocionales o de demostración de forma programática y consistente.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/cskwork/motion-graphics-skill/tree/HEAD/skills/motion-graphics

Preguntar en tu IA favorita

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

Documentación

motion-graphics

Un video es una página HTML cuyos píxeles son una función pura del tiempo t, renderizada fotograma a fotograma en Chromium sin interfaz gráfica y codificada con ffmpeg. El estándar es el reel de un diseñador senior de motion graphics, nunca una presentación de diapositivas.

1. Elegir el formato

SolicitudLeer
Lanzamiento, promoción, comercial, reel de características, tráiler de app para un producto realformats/launch-video.md
Shorts, Reels, TikTok, explicativo o historia verticalformats/shorts.md

Sigue el archivo de formato para el resumen, los pasos de contenido y la estructura de tiempos. Después regresa aquí para la construcción. También lee references/pitfalls.md antes de escribir la composición.

Concepto fresco en cada ejecución. Cada video tiene su propia idea, guion y aspecto. Cuando el usuario indique que no se revise trabajo anterior, deja los videos y composiciones previos en el espacio de trabajo sin abrir.

2. Carpeta de trabajo

Crea <slug>-<AAAAMMDD>/ donde el usuario quiera (por defecto: el directorio actual):

brief.md          parámetros de la tabla de resumen del formato
beats.md          la hoja de tiempos (tiempo, texto, recurso, movimiento, transición, acento)
assets/           capturas, imágenes, fuentes, audio
assets/manifest.md  una línea por archivo de recurso: fuente, licencia o "capturado de <superficie>", qué muestra
motion.html       la composición
motion.json       {"size": [W, H], "fps": 60, "duration": 30, "stills": [tiempos de beats], "captions": []}
engine/           copiado del motor de esta habilidad
out/              fotogramas fijos, renderizados, hoja de contacto

Configura el motor una vez por carpeta:

cp -R <esta-habilidad>/engine engine && (cd engine && npm install && npx playwright install chromium)

3. Componer

motion.html carga engine/runtime.css y engine/runtime.js, construye su DOM, registra escenas y luego llama a MG.ready().

HelperUso
MG.scene(start, end, fn, el)fn(local, t, dur) se ejecuta mientras start <= t < end; el está oculto fuera. Establece cada propiedad animada en cada llamada.
MG.always(fn)Se ejecuta en cada fotograma: fondos, grano, barras de progreso.
MG.prog(t, a, b, ease)Progreso suavizado 0..1. Suavizados: MG.ease.* (linear, in/out/inOut Quad, Cubic, Quart, Expo, inBack, outBack, outElastic, outBounce) o cualquier función.
MG.tween(t, [[t0, v0], [t1, v1, ease], …])Fotogramas clave; los valores pueden ser arrays.
MG.spring(t, {stiffness, damping})Físico 0 → 1 con rebasamiento.
`MG.split(el, "grapheme""word")`
MG.set(el, {x, y, s, sx, sy, r, o, blur, ...css})Una llamada por elemento por fotograma.
MG.clip(videoEl, start, rate)Reproduce una grabación de pantalla con precisión de fotograma desde start.
MG.rng(seed), MG.noise(x, seed)Aleatoriedad determinista y ondulación.
MG.fmt(n, {decimals})Formato de números localizado para contadores.
MG.captions()Dibuja los subtítulos de motion.json encima del bloque inferior de la interfaz.

Determinismo: no usar Date, performance.now(), requestAnimationFrame ni Math.random en la lógica de renderizado. @keyframes de CSS están permitidos; el runtime los pausa en t, así que temporízalos con animation-delay. Usa solo las fuentes e imágenes listadas en el manifiesto.

Previsualizar un fotograma: open "motion.html?w=1920&h=1080&t=3.2&guides=1" (las guías muestran zonas seguras). Tiempo real: ?play=1. Los subtítulos solo se muestran en los renderizados.

4. Nivel de calidad

  • El fotograma 0 ya está en movimiento. Sin fundido desde negro, sin introducción de logotipo.
  • Algo significativo cambia cada 0.8–2 s: diseño, escala, color, número o cámara.
  • Las entradas usan resortes o ease-out-expo con ligero rebasamiento; escalonamientos de 30–60 ms; solo lineal para marcadores.
  • Desenfoque de movimiento solo durante movimientos rápidos; un push lento (escala 1 → 1.04) en tomas fijas; paralaje en 2–3 capas de profundidad.
  • Una familia de fondo, un color de texto, un acento. Añade grano o ruido degradado para que los rellenos planos no se bandeen después de la subida.
  • El texto en pantalla permanece el tiempo suficiente para leerlo dos veces; el texto clave se mantiene dentro de las zonas seguras.
  • Los beats coinciden con el sonido: un whoosh, un golpe o un beat musical en cada cambio.

5. Renderizar

node engine/render.mjs --html motion.html --config motion.json --stills <t1,t2,...> --stills-dir out/stills
node engine/render.mjs --html motion.html --config motion.json --out out/video.mp4 --workers 4

Ajusta el diseño primero con fotogramas fijos: uno por beat, uno dentro de cada interpolación, uno en cada pico de rebasamiento de resorte. Ejecuta un renderizado completo a la vez (aproximadamente 10 minutos para 25 s a 1080p60 con 4 workers).

6. Audio

Usa solo música y SFX listados en el manifiesto con una licencia que permita su uso, o archivos que el usuario proporcione. Sin ellos, entrega sin sonido e indícalo. Mezcla las pistas, luego multiplexa:

ffmpeg -i music.wav -i whoosh.wav -filter_complex \
  "[0]volume=-16dB[m];[1]adelay=1200|1200,volume=-8dB[a];[m][a]amix=inputs=2:normalize=0[out]" -map "[out]" out/mix.wav
ffmpeg -i out/video.mp4 -i out/mix.wav -map 0:v -map 1:a -c:v copy \
  -af "loudnorm=I=-14:TP=-1.5:LRA=11" -c:a aac -b:a 256k -shortest -movflags +faststart out/final.mp4
ffmpeg -i out/final.mp4 -af ebur128=peak=true -f null - 2>&1 | grep -E "^ +(I|Peak):"

Apuntar a aproximadamente −14 LUFS integrado y pico verdadero en o por debajo de −1 dBFS. Los SFX deben estar alrededor de −6 a −14 dB, la música −14 a −18 dB. La música bajo texto en pantalla debe ser instrumental.

7. QA

  1. ffprobe duración, tamaño y fps coinciden con el resumen.
  2. Hoja de contacto: ffmpeg -i out/final.mp4 -vf "fps=2,scale=360:-1,tile=10x6" -frames:v 1 out/contact.png. Revísala junto con un fotograma a tamaño completo en cada cambio de beat (ffmpeg -ss <t> -i out/final.mp4 -frames:v 1 out/check-<t>.png).
  3. Cada fotograma: nada recortado en los bordes, sin fotogramas en blanco o medio fundidos, sin guías sobrantes, sin errores tipográficos ni texto de relleno, nada estático por más de 2 s.
  4. Las comprobaciones propias del archivo de formato.

Corrige y vuelve a renderizar hasta que todas las comprobaciones pasen. Añade cualquier nueva lección a references/pitfalls.md en la habilidad como fecha · video · lección.

Entregar

Informa la ruta del MP4 final, duración, tamaño y fps, qué muestra, estado del audio con créditos necesarios y los comandos de re-renderizado. Mantén la carpeta de trabajo. Sube o publica solo cuando el usuario lo solicite.

Skills relacionados