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")
- 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).
- 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). - 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.ttfdeSocialMedia/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. - 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. - Muestra una hoja de fotos de tu versión junto a la de la referencia y corrige las diferencias antes de entregar.
- 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 enmotor/ui.jsymotor/ui.css; ejemplo completo enejemplos/video-con-letra/.
Antes de empezar
Necesitas saber, y si no está claro lo preguntas en un solo mensaje, con valores por defecto propuestos:
- Qué se anuncia y para quién (una línea).
- 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.
- Formato y duración: 9:16 y de 15 a 20 s por defecto. 16:9 para web o YouTube.
- Voz: ElevenLabs (definitiva),
say(borrador) o sin voz. - 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 escribeguion.tiempos.jsoncon 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:
spot.escena('id', (capa, c) => { ... })con sus tres capas, su deriva de cámara y sus técnicas.- Sincroniza con la voz:
spot.cuando('id', 'palabra'). 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.mp4ysalida/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 encalidad.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
- Todo es función del tiempo
t. Nada deMath.random,Date.now, animaciones CSS,setTimeoutnirequestAnimationFrameen el spot. Para el azar:ruido(i)oazar(semilla). - Nunca pongas
transformen el CSS de algo que GSAP anima (usaxPercent/yPercent). Es la causa número uno de elementos descuadrados. - Mira las fotos de cada escena antes de seguir. No se entrega nada que no se haya visto.
- Activos reales o se dice que son de ejemplo. Las interfaces se recrean con fidelidad a partir de capturas, no se inventan "genéricas".
- 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.
- Datos: son del usuario o se marcan como ilustrativos.
- 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.
- Contexto: un spot gasta bastante. Si la sesión pasa del 40 % de contexto, compacta antes de seguir construyendo.
- 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 enletra.jsoncon 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 enreferences/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íntoma | Causa probable |
|---|---|
window.spot.listo nunca es true | Error 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 salta | transform 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 negro | El id no está en el guion (corre preparar.mjs), o una transición dejó la capa con opacity: 0 |
| El 3D se ve plano | Falta transform-style: preserve-3d en un contenedor intermedio, o hay un overflow o filter en medio |
| La voz y la imagen no coinciden | Ajusta ± 0,1 s sobre spot.cuando(...); revisa en servir.mjs con audio |
| El render tarda mucho | Usa --blur 1 --escala 0.5 para borradores; reduce los nodos con sombra o desenfoque; baja n en voxelOla o particulas |
| El MP4 pesa demasiado | Es el grano: --grano 3 o --crf 22; para subir, --subida |