Communitygithub.com

motion-spot

Produce spots de motion graphics de nivel agencia (anuncios de producto y de app, spec ads, lanzamientos, intros de marca, showreels) 100 % con código. Usa HTML con GSAP, CSS 3D y Three.js, renderizado cuadro a cuadro con desenfoque de movimiento real, voz en off y música compuesta o propia. Úsala cuando pidan "hazme un spot", "un anuncio animado", "motion graphics", "un comercial de mi app o negocio", "un video estilo Apple, Nike, Spotify o Google Maps", "un promo de producto", "un video tipo itskeo", "anima mi marca", "un showreel" o "un video a partir de esta web", o cuando haya que convertir un producto en un video pulido de 10 a 45 segundos.

What is motion-spot?

motion-spot is a Claude Code agent skill that produce spots de motion graphics de nivel agencia (anuncios de producto y de app, spec ads, lanzamientos, intros de marca, showreels) 100 % con código. Usa HTML con GSAP, CSS 3D y Three.js, renderizado cuadro a cuadro con desenfoque de movimiento real, voz en off y música compuesta o propia. Úsala cuando pidan "hazme un spot", "un anuncio animado", "motion graphics", "un comercial de mi app o negocio", "un video estilo Apple, Nike, Spotify o Google Maps", "un promo de producto", "un video tipo itskeo", "anima mi marca", "un showreel" o "un video a partir de esta web", o cuando haya que convertir un producto en un video pulido de 10 a 45 segundos.

Works with✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/santiagosantofimio/motion-spot/tree/HEAD

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

What does motion-spot do?

Hace spots que parecen de estudio, con un método sacado del análisis de 45 spots hechos con Claude que llegaron a millones de vistas (references/estudio.md). La receta que se repite en todos:

Un concepto con tensión (no una lista de funciones) + la interfaz o el producto real como protagonista + tipografía cinética + una cámara que nunca está quieta + cada cosa justo cuando la voz la nombra + un pico en el color de la marca + un cierre limpio con logo y lema.

Todo es código: cada cuadro es un estado de una página web. Una línea de tiempo de GSAP en pausa se recorre cuadro a cuadro en Chrome sin ventana, y ffmpeg arma el MP4 con desenfoque de movimiento, resplandor y grano. El motor ya está hecho y probado en plantilla/motor/, con un spot de ejemplo completo en plantilla/escenas.js.

Si el usuario da un video de referencia ("haz lo mismo")

  1. Desarma la referencia antes de diseñar: 8 a 12 fotogramas por segundo de los tramos clave a buen tamaño (hoja de contacto con Read), anotando cada elemento: qué UI real aparece, qué fuente, qué color, cómo entra y sale (estirar, desenfocar, voltear).
  2. Copia la estructura y los elementos reales, no un "equivalente genérico": si el original usa burbujas de iMessage, usa -apple-system (SF del sistema) y burbuja con cola; si usa la tarjeta de letra de Spotify, recréala con su etiqueta, botones y color; si usa una palabra gigante, es Arial Black (viene en macOS).
  3. Tipografía: nunca la de siempre. El usuario ha rechazado varias veces la tipografía por defecto de Claude (sans negra apretada con tracking muy negativo, Inter, serif itálica). Usa la fuente de la marca en sus cortes ESTÁTICOS reales (p. ej. MonaSans-Black/Bold/Regular.ttf de SocialMedia/fuentes/, las mismas de los videos de ilustración) con tracking normal (-0,01 em como mucho), la de la referencia si hay, o pregunta/muestra 3 pruebas antes de renderizar. Nunca fuentes variables a peso intermedio con tracking apretado. 3b. Prohibido por defecto el "look Claude": Inter/Anton/serif itálica/HUD mono salen solo si la referencia o la marca los usa. Con referencia, la tipografía y los elementos son los suyos.
  4. Pide capturas reales de lo que no se pueda recrear fiel (app, reproductor, portada): el usuario las suelta en activos/. Spotify y otras apps pueden estar bloqueadas para control por política: no se rodea el bloqueo, se pide la captura o se usa una imagen pública y se avisa.
  5. Muestra una hoja de fotos de tu versión junto a la de la referencia y corrige las diferencias antes de entregar.
  6. Lee references/referencia-fiel.md: proceso completo, recetas de cada elemento (burbujas de Apple Messages, tarjeta de letra de Spotify, controles en SVG, sombreado que se desliza) y los errores que ya costaron rondas. Piezas listas en motor/ui.js y motor/ui.css; ejemplo completo en ejemplos/video-con-letra/.

Antes de empezar

Necesitas saber, y si no está claro lo preguntas en un solo mensaje, con valores por defecto propuestos:

  1. Qué se anuncia y para quién (una línea).
  2. Activos reales: logo (SVG mejor), capturas de la app o la web, fotos del producto, colores. Un sitio web también sirve. Sin activos reales la marca se ve genérica: pídelos siempre. Si no hay, se diseña una identidad de ejemplo y se dice.
  3. Formato y duración: 9:16 y de 15 a 20 s por defecto. 16:9 para web o YouTube.
  4. Voz: ElevenLabs (definitiva), say (borrador) o sin voz.
  5. Música: compuesta por el motor o una pista propia (recomendado para publicar).

Si el usuario trae un encargo completo (references/encargo.md) o dice "las decisiones son tuyas", no preguntes: produce y explica después en DECISIONES.md.

Flujo

1. Proyecto

bash ~/.claude/skills/motion-spot/scripts/nuevo.sh <carpeta-del-spot>          # con el ejemplo "Turnito" como referencia
bash ~/.claude/skills/motion-spot/scripts/nuevo.sh <carpeta-del-spot> --limpio # esqueleto vacío

Copia la plantilla, instala dependencias (unos 10 s) y comprueba que Chrome esté disponible. Copia los activos del usuario a activos/.

2. Concepto y arquetipo

Lee references/arquetipos.md y elige uno (más un plano prestado para el momento wow). Escribe:

  • El concepto en una frase, con su tensión: "El caos del sábado contra la calma de reservar en 3 toques".
  • El insight de marca: un detalle propio de la marca que nadie más podría usar (la flecha de Amazon que une la A con la Z, el swoosh que corta la pantalla). Si no hay uno, el spot será genérico.

3. Guion de voz → guion.json

Lee references/voz-y-musica.md. La voz se escribe antes que la animación, porque marca el tiempo de todo. Una frase por escena, de 2 a 8 palabras, con tildes y signos de apertura. Gancho de situación ("Son las 2 de la mañana..."), acción, beneficio, pico y marca + lema. Escribe guion.json con las escenas, el BPM, el estilo de música, la escena pico y los efectos.

4. Hoja de planos

Una tabla, una fila por escena: tiempo · voz · héroe · cámara · técnicas de motion graphics (3 o más, de references/lenguaje.md) · transición de salida. Reglas:

  • Tres capas por plano: fondo vivo + héroe + detalle.
  • La cámara siempre se mueve. Transiciones de motion graphics (corte en el beat, zoom a través, cortina, iris, empuje), no fundidos.
  • Un pico hacia el 70 % en el color de la marca o en 3D.
  • Mínimo 8 técnicas distintas en el spot.

Si el spot es largo o caro, muéstrale la hoja al usuario antes de construir. Si pidió "hazlo", sigue.

5. Sistema visual → estilo.css

Lee references/diseno.md. Define variables (--fondo, --tinta, --acento, --acento2...) y las clases de la interfaz recreada con prefijo propio (.ui ...). Tipografía: sans negra apretada + una palabra en serif itálica + mono para el HUD (ya vienen instaladas: Inter, Instrument Serif, JetBrains Mono y Anton).

6. Voz y tiempos

  • ElevenLabs: una generación por escena → audio/voz/<id>.mp3 → node motor/preparar.mjs --recortar.
  • Borrador: node motor/preparar.mjs --borrador-voz.
  • Luego node motor/preparar.mjs: mide las voces, cuantiza los cortes al pulso y escribe guion.tiempos.json con el tiempo estimado de cada palabra.

7. Construir escena por escena → escenas.js

Lee references/motor.md (API, recetas y trampas conocidas). Por cada escena:

  1. spot.escena('id', (capa, c) => { ... }) con sus tres capas, su deriva de cámara y sus técnicas.
  2. Sincroniza con la voz: spot.cuando('id', 'palabra').
  3. node motor/render.mjs --fotos <inicio+0.1>,<mitad>,<fin-0.1> y mira la hoja (salida/fotos/hoja.jpg) con Read. Corrige antes de seguir.

Usa plantilla/escenas.js (Turnito) como referencia de nivel: cómo se hace la oclusión, la órbita, la rueda de hora, las notificaciones, el 3D de vóxeles, la cortina y el zoom a través.

8. Música y mezcla

node motor/musica.mjs   # compone al BPM, con caída en la escena "pico"; o usa la pista propia de guion.json
node motor/mezcla.mjs   # voces + música con ducking + efectos, a -14 LUFS

Con node motor/servir.mjs el usuario puede ver la vista previa con audio y recorrerla.

9. Render, revisión y pulido

node motor/render.mjs --fotos                 # hoja de 12 fotos: composición, ortografía y zonas seguras
node motor/render.mjs --subida                # final: 30 fps, desenfoque 4×, acabado, más la copia de < 10 MB (2 a 3 min por cada 20 s)

Pasa la lista de references/calidad.md (tres pasadas). Luego haz una vuelta solo de pulido: microanimaciones secundarias, acentos en los golpes, primeros y últimos cuadros de cada escena. La segunda vuelta es la que separa lo bueno de lo excelente.

10. Entrega

  • salida/spot.mp4 y salida/spot-subida.mp4.
  • Portada: la foto del momento más llamativo, no la primera.
  • DECISIONES.md: concepto, arquetipo, decisiones, lo descartado, iteraciones y tiempo (plantilla en calidad.md).
  • En el chat: la ruta, qué es borrador (voz say, música sintetizada) y 2 o 3 mejoras concretas.

Reglas que no se rompen

  1. Todo es función del tiempo t. Nada de Math.random, Date.now, animaciones CSS, setTimeout ni requestAnimationFrame en el spot. Para el azar: ruido(i) o azar(semilla).
  2. Nunca pongas transform en el CSS de algo que GSAP anima (usa xPercent/yPercent). Es la causa número uno de elementos descuadrados.
  3. Mira las fotos de cada escena antes de seguir. No se entrega nada que no se haya visto.
  4. Activos reales o se dice que son de ejemplo. Las interfaces se recrean con fidelidad a partir de capturas, no se inventan "genéricas".
  5. Marcas de terceros: un spot de una marca real que no es del usuario es un ejercicio de portafolio ("spec"). No se publica como si fuera oficial, no se sugiere relación con la marca y su logo no se deforma.
  6. Datos: son del usuario o se marcan como ilustrativos.
  7. No puedo oír. Verifico niveles (pico de -1 a -2 dB, -14 LUFS) y que la voz suene encima de la música; el usuario juzga de oído.
  8. Contexto: un spot gasta bastante. Si la sesión pasa del 40 % de contexto, compacta antes de seguir construyendo.
  9. Letras de canciones: Claude no las escribe en ningún lado (código, letra.json, chat), aunque el usuario las pase. Para videos con letra: tiempos en letra.json con el texto vacío, spot que funciona con y sin letra, validación con frases neutras en una copia de prueba, y el usuario pega la letra y corre el render final. Detalle en references/motor.md → "letra.json".

Videos musicales y con video de fondo

node motor/extraer.mjs <video> --desde S --hasta S saca los cuadros (activos/clip/) y el audio del tramo; videoCuadros(...) los muestra sincronizados; motor/letra.js hace el karaoke desde letra.json. Arquetipo 9 en references/arquetipos.md.

Si algo falla

SíntomaCausa probable
window.spot.listo nunca es trueError de JS en escenas.js: el render imprime los errores de la página. Revisa los imports y que exista await spot.terminar()
Un elemento aparece descuadrado o saltatransform en el CSS más GSAP; o una clase que choca con otra (.app); o un selector descendiente demasiado amplio
Una escena se ve en blanco o negroEl id no está en el guion (corre preparar.mjs), o una transición dejó la capa con opacity: 0
El 3D se ve planoFalta transform-style: preserve-3d en un contenedor intermedio, o hay un overflow o filter en medio
La voz y la imagen no coincidenAjusta ± 0,1 s sobre spot.cuando(...); revisa en servir.mjs con audio
El render tarda muchoUsa --blur 1 --escala 0.5 para borradores; reduce los nodos con sombra o desenfoque; baja n en voxelOla o particulas
El MP4 pesa demasiadoEs el grano: --grano 3 o --crf 22; para subir, --subida

Related Skills