Communitygithub.com

motion-format

Crea videos de motion graphics mediante chat con el flujo de trabajo Motion Format — Reels/TikTok/Shorts 9:16, YouTube 16:9 o feed 1:1 — desde el brief hasta MP4 con sonido (voz en off + efectos de sonido ElevenLabs, subtítulos palabra por palabra). Incluye recetas de estilo listas para usar de las series de contenido Motion Format: Isométrico Desmontado (cómo funcionan las máquinas, 3D), Historia 3D Cinematográfica (edificios y eventos históricos), Cuerpo Humano Anime (órganos del cuerpo), Mundo 2D Texturizado (noir, acuarela, grabado, paisaje anime), Dibujo Animado Cel Brillante (personajes explicando), Mapa en Relieve Cinematográfico (geografía, rutas, regiones) y Promo de Producto y Publicidad (PYMES, aplicaciones, flash sale) — además de cómo crear tu propio estilo.

¿Qué es motion-format?

Motion Format v2 es una habilidad especializada para asistentes de IA (como Claude Code, Cursor o Codex) que permite crear videos de motion graphics completos directamente desde un chat. El flujo de trabajo guía al usuario desde un brief inicial (5 puntos clave + tipo de sonido) hasta un archivo MP4 renderizado, pasando por la definición del estilo visual, generación de storyboard, escritura de guion, síntesis de voz (ElevenLabs), construcción de animaciones (HTML + canvas/three.js + GSAP) y renderizado frame a frame. La habilidad es ideal para creadores principiantes que no son programadores ni animadores. Incluye recetas de estilo predefinidas para diferentes tipos de contenido (explicaciones técnicas, historias, anatomía, promociones, etc.) y permite crear estilos personalizados. El proceso se divide en 8 pasos secuenciales, con revisiones tempranas del estilo visual antes de generar el audio, lo que ahorra créditos de ElevenLabs. Soporta múltiples formatos de video (9:16, 16:9, 1:1) y la gestión de proyectos con una estructura de carpetas estandarizada y comandos Python para crear, ensamblar, capturar, generar subtítulos y renderizar. Entre sus características destacadas: subtítulos sincronizados palabra por palabra, énfasis en movimiento continuo (sin transiciones de diapositivas), hook visual en los primeros 2 segundos, gestión de revisiones con historial de cambios, y una biblioteca de efectos de sonido libres de derechos.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/hasbiridwan57-creator/hermes-video-motion-skills/tree/main/motion-format

Preguntar en tu IA favorita

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

Documentación

Motion Format v2 — video mediante chat, con el flujo de trabajo Motion Format

Esta habilidad es la forma en que el equipo de Motion Format crea contenido: desde una sola pregunta o un solo producto, hasta un video MP4 con sonido listo para subir. Todas las recetas de estilo aquí provienen de las series de contenido que realmente producimos. Los videos se construyen como páginas web en movimiento (HTML + canvas/three.js + GSAP) y luego se renderizan fotograma a fotograma a MP4.

1. A quién ayudas

Los usuarios suelen ser principiantes: no son programadores ni animadores. Dirigen mediante chat.

  • Responde en español relajado, con frases cortas. No pegues código en el chat a menos que te lo pidan. Cuenta lo que estás haciendo con palabras descriptivas ("estoy creando la escena 1: la cámara desciende desde arriba de la lavadora, luego la pared se abre").
  • Los términos técnicos se explican en una frase la primera vez que aparecen ("relación 9:16 = pantalla de móvil vertical").
  • Las decisiones que necesite el usuario se presentan como opciones breves + una recomendación.
  • Nunca pidas una clave de API. No gastes créditos de ElevenLabs del usuario sin su consentimiento.

2. Flujo de trabajo Motion Format (sigue el orden)

#PasoResultadoPuerta
1Brief — 5 cosas + sonidoresumen del brief en el chatpreguntar máximo 1 vez
2Estilo — usa el estilo mencionado, o ofrece 3estilo.mdusuario acepta
3Imagen de prueba escena 1 — sin sonido3 capturas de escena 1usuario acepta
4Guion por escenaguion.mdusuario acepta
5Sonido — prueba la escena 1 primero, luego todoassets/audio/*.mp3, palabras.jsusuario escucha la prueba
6Construir todas las escenas siguiendo el tiempo del sonidoescena.htmlcomprobar mediante hoja de contactos
7Vista previa y revisión de 1 frase (siempre hacer copia de seguridad primero)nueva versiónusuario satisfecho
8Renderizar — comprobar 8 segundos, luego completo<proyecto>.mp4—

Por qué primero la imagen y luego el sonido: el estilo visual es lo que más suele revisarse. Si el sonido se hace primero y luego se cambia el estilo, se desperdician créditos de ElevenLabs. El tiempo de la escena 1 en la imagen de prueba puede ser aproximado; después de tener el sonido, el tiempo se ajusta al sonido (paso 6).

Paso 1 — Brief: 5 cosas

#CosaValor por defecto si el usuario dice "lo que sea"
1¿Qué quieres hacer?: explicativo/educativo, promo/anuncio, intro, kinetic type— (obligatorio)
2Tema/producto + materiales (logo, foto del producto, enlace, datos)sin materiales → se dibuja con código
3¿Para quién?público general
4Duraciónexplicativo 30–45 s · promo 15–20 s
5Formato9:16 + subtítulos (Reels/TikTok/Shorts); 16:9 si es para YouTube normal

Además sonido: VO + efectos de sonido ElevenLabs (por defecto si el plugin ElevenLabs está conectado), solo efectos de sonido, o sin sonido. Toma todo lo que ya esté en el mensaje del usuario; pregunta el resto en un solo mensaje, con los valores por defecto ya rellenados, combinado con la pregunta del estilo (paso 2) si el estilo aún no se ha mencionado. No preguntes de forma repetitiva.

Paso 2 — Estilo

  • El usuario ya mencionó un estilo (nombre del estilo en la tabla de la sección 3, "Receta de Estilo" de la clase, un estilo que él mismo describió, o una imagen/video de ejemplo) → úsalo directamente. No ofrezcas otros estilos, no preguntes por el estilo de nuevo. Lee la receta en references/estilos/<id>.md.
  • Promo/anuncio de producto, servicio, aplicación o tienda → estilo promo-producto directamente, sin ofrecer 3 estilos. Elige tú mismo la dirección visual según la marca (cálido local / limpio premium / pop atrevido) y menciónala en una frase en el brief, para que el usuario pueda corregir.
  • Aún no lo ha mencionado (explicativo/educativo sin estilo) → ofrece 3 opciones de estilo que mejor se adapten al tema (de la tabla de la sección 3, o estilo personalizado), cada una con una frase descriptiva + una recomendación. La respuesta "lo que sea" = usar la recomendación.
  • La solicitud del usuario anula la receta. Si el prompt del usuario contradice la receta (ej. "sin perspectiva", "acento azul", "sin subtítulos"), sigue al usuario y omite la parte de la receta que esté en contradicción. Menciona en una frase si eso elimina una característica importante del estilo.
  • Luego escribe estilo.md en la carpeta del proyecto (hoja de estilo, ±10 líneas): estilo + variante, paleta hex, fuente, cámara, luz/textura, subtítulos (estilo y posición), firma de movimiento (un movimiento característico que se repite), y 1 cosa que haga que este video sea diferente del anterior. Esta hoja se mantiene hasta el final, incluso durante las revisiones.

Paso 3 — Imagen de prueba escena 1

  1. python3 <habilidad>/scripts/mf.py nuevo <proyecto> --base <id-estilo> --relacion 9:16 (o --base 2d / 3d para estilos personalizados). Reemplaza el contenido del ejemplo con el tema del usuario: objeto, colores, texto. El ejemplo de escena es un patrón, no una plantilla de contenido: para otros temas, el objeto principal y su mundo suelen reescribirse (mantén el esqueleto: renderizador/canvas, cámara, luz, texto, subtítulos). Todos los tiempos importantes deben reunirse en un solo objeto TIEMPO al principio, para poder ajustarlo fácilmente después.
  2. Construye solo la escena 1 (±8 segundos, apertura/gancho) con calidad final, no un boceto.
  3. python3 <habilidad>/scripts/mf.py captura <proyecto> --t <segundos> — usa los segundos sugeridos en la sección "Imagen de prueba" de la receta del estilo (si no hay: 0.5,3,7) → lee hoja.jpg con Read, corrige tú mismo hasta que coincida con estilo.md y su receta.
  4. Muéstraselo al usuario: menciona la ruta completa hoja.jpg entre comillas (y index.html para abrir en el navegador; en Mac puedes usar directamente open "<ruta>"), explica las 3 capturas en 2–3 frases, pregunta "¿continuamos o hay algo que quieras cambiar?". Las revisiones aquí son baratas: aún no hay sonido.

Paso 4 — Guion

Escribe guion.md: tabla # · escena (lo que se ve) · frase VO · segundos aproximados. Frases orales y cortas; los números se escriben como se pronuncian. Aproximación para español ±3.5 palabras/segundo. Menciona el crédito estimado (≈ número de caracteres del guion). Espera la aprobación.

Paso 5 — Sonido

Lee references/sonido-elevenlabs.md. Resumen: elige una voz (2–3 opciones + recomendación), genera primero la escena 1 para que el usuario la pruebe, luego el resto, un clip por escena, 1 variación por generación. Guarda en assets/audio/, completa ESCENA.audio.vo con texto, luego mf.py palabras <proyecto> para que los subtítulos sigan al sonido.

Paso 6 — Construir todas las escenas

El tiempo de las escenas se deriva del tiempo del sonido (palabras.js / duración del clip), no al revés. Construye 2–3 escenas, captura, lee la hoja, corrige; repite. Antes de mostrárselo al usuario, haz una ronda especial "más detalle" en la escena más débil (añade textura, capas, partículas, luz). Cero errores de JS (mf.py captura los imprime).

Paso 7 — Revisión de 1 frase

Lee references/revision.md. Siempre mf.py copia-seguridad <proyecto> "<contenido de la revisión>" antes de modificar, cambia SOLO lo solicitado, ensambla, captura la parte modificada, informa brevemente. "Vuelve a la anterior" → mf.py restaurar <proyecto>.

Paso 8 — Renderizado

mf.py renderizar <proyecto> --hasta 8 → pide al usuario que vea un momento (¿el sonido está bien? ¿los efectos no tapan la voz?) → mf.py renderizar <proyecto>. Resultado <proyecto>/<nombre-carpeta>.mp4.

3. Estilos incorporados

idEstiloAdecuado paraTécnica
isometrico-desmontadoIsométrico Desmontadocómo funcionan las máquinas, electrodomésticos, infraestructurathree.js cámara ortográfica, plano de corte
historia-3dHistoria 3D Cinematográficaedificios históricos, eventos, barcos, ciudades antiguasthree.js cinematográfico, bloom, niebla
cuerpo-animeCuerpo Humano Animeórganos y procesos del cuerpo, salud ligeracanvas pintado, cielo crepuscular
mundo-2dMundo 2D Texturizado (varias variantes)misterio, cuentos de hadas, naturaleza, ciencia, historia narrativacanvas textura: noir, acuarela, grabado, paisaje anime
dibujo-celDibujo Animado Cel Brillantepersonajes explicando, consejos, diálogos, educación juvenilcanvas cel-shading, personajes con expresiones
mapa-relieveMapa en Relieve Cinematográficogeografía, rutas, fronteras, distribución, migracióncanvas + datos de línea de costa
promo-productoPromo de Producto y PublicidadPYMES, productos físicos, aplicaciones, flash sale, testimoniosDOM + canvas, kinetic type, maqueta

Estilos fuera de la tabla → personaliza tú mismo con references/personalizar-estilo.md (empieza con --base 2d o --base 3d). Los estilos incorporados también se pueden personalizar: cambia paleta/fuente/fondo con las variantes de la receta para que dos videos no sean idénticos.

Paquete de Plantillas Motion (producto adicional de Motion Format, opcional): si la carpeta de esta habilidad tiene references/paquete-plantillas.md, ese paquete está instalado. Para solicitudes de logo reveal, intro de canal, lower third, suscríbete, end screen, CTA, cita, lista de puntos, título de capítulo, gancho de Reels, promo breve o transición, lee ese documento y usa sus plantillas. Si no existe, crea desde los estilos incorporados.

Bonus de Efectos de Sonido (34 efectos, 8 categorías): si la carpeta de esta habilidad tiene assets/sfx/, la biblioteca de efectos de sonido adicional está instalada en assets/sfx/<categoría>/<nombre>.mp3 (01 Whoosh y Transición, 02 Clic y UI, 03 Pop y Notificación, 04 Impacto y Golpe, 05 Riser y Drop, 06 Glitch y Digital, 07 Texto y Números, 08 Especiales). Si el usuario pide SFX — o al componer ESCENA.audio.sfx — prioriza tomar de aquí (ruta relativa desde el proyecto: copia los archivos usados a <proyecto>/assets/audio/). Todos los efectos son sintetizados, se pueden usar libremente en videos de clientes/monetización sin atribución.

4. Reglas de video (resumen — detalles en references/reglas-video.md)

  1. Video, no diapositiva. La cámara siempre se mueve; el mundo tiene capas frontal-media-trasera; las transiciones entre escenas se enlazan (objeto/cámara/acción), no "cambiar de página" con fundido.
  2. Segundos 0–2 = gancho visual: algo ya se mueve y es impactante en el primer fotograma.
  3. Los momentos importantes tienen tiempo ±2.5 segundos; no tengas prisa.
  4. Texto legible: dentro de la zona segura (SEGURO), alto contraste, sin cajas/carteles a menos que el estilo lo pida. Las etiquetas = punto + línea que apunta al objeto (etiqueta()).
  5. Subtítulos palabra por palabra se iluminan según el sonido (por defecto para 9:16). Las palabras clave tienen color de acento.
  6. Cada video es diferente del anterior: paleta, fuente, fondo o firma de movimiento — al menos 3 de 4. Excepto series (Parte 1, 2, …): las series deben ser consistentes.
  7. Los datos en pantalla = datos en el guion. No inventes números.
  8. Todos los movimientos se calculan a partir del tiempo t (regla del motor, ver más abajo).

5. Motor y herramientas (detalles en references/motor.md)

Estructura de carpeta del proyecto:

<proyecto>/
  escena.html     ← lo que editas (escenas, estilo, tiempos)
  index.html     ← resultado del ensamblaje (no editar; se abre en el navegador)
  estilo.md  guion.md  palabras.js
  assets/audio/  assets/imagenes/
  hoja.jpg  .capturas/  .historial/

Comandos (<habilidad> = carpeta de esta habilidad):

python3 <habilidad>/scripts/mf.py nuevo <proyecto> --base <id-estilo|2d|3d> --relacion 9:16
python3 <habilidad>/scripts/mf.py ensamblar <proyecto>
python3 <habilidad>/scripts/mf.py captura <proyecto> [--t 0.5,3,7]
python3 <habilidad>/scripts/mf.py palabras <proyecto>
python3 <habilidad>/scripts/mf.py copia-seguridad <proyecto> "nota"   ·   historial   ·   restaurar [numero]
python3 <habilidad>/scripts/mf.py renderizar <proyecto> [--hasta 8]

Requiere Python 3, Google Chrome y ffmpeg. Si no tienes ffmpeg → Mac brew install ffmpeg, Windows winget install Gyan.FFmpeg (pídele al usuario que lo ejecute si tú no puedes).

Regla de oro del motor: escena.html define const ESCENA = {dur, fotograma(t), …}. Cada posición, color, cámara, partícula se calcula a partir de t. Prohibido: Date, performance.now, requestAnimationFrame, setTimeout, Math.random() sin semilla (usa rng(semilla)). Si se infringe, el MP4 será diferente de la vista previa o se romperá.

6. Antes de entregar al usuario

  • Cumple con estilo.md (paleta, fuente, cámara, textura) — verifica en la hoja, no de memoria
  • El gancho se mueve desde el primer fotograma; ninguna escena se siente como diapositiva
  • Texto y subtítulos en zona segura, legibles, ortografía correcta, no chocan con objetos importantes
  • Sonido: subtítulos sincronizados con la voz; efectos de sonido en las pausas, no tapan palabras
  • mf.py captura sin errores de JS
  • Renderizado de prueba de 8 segundos visto por el usuario antes del renderizado completo
  • Informe al usuario: ruta del MP4, duración, y 1–2 cosas que quizás quiera revisar

7. Si el usuario pregunta "¿por qué el resultado no es exactamente igual al video de ejemplo de Motion Format?"

Responde con honestidad y brevedad: el video de ejemplo es el resultado de varias rondas de revisión; la receta da la sensación del estilo, los detalles llegan con las revisiones. Ofrece la revisión más impactante de la sección "Revisión rápida" de la receta del estilo.

Individual skills in this repo

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

Skills relacionados