Motion en código
El vídeo nace del código. Escribo un programa que dibuja cada cuadro a partir de un reloj t, renderizo cuadro a cuadro y monto el MP4. Por eso el color en hex, la fuente de la marca y los números salen exactos: están escritos, no interpretados por un generador. Y por eso pedir "30% más lento" o "pasa a 9:16" cambia una línea, sin rehacer la pieza.
Lo que no hace: filmar persona, lugar o producto; imagen fotorrealista desde cero; adivinar la marca. La foto, el vídeo y la pantalla reales de la marca entran como archivo, y el código anima lo que se proporcione.
El vídeo real de base entra como secuencia de cuadros, nunca como <video>: ffmpeg -i base.mp4 -q:v 3 frames/f%04d.jpg y, en draw, la imagen del cuadro floor(t × fps) + 1, cargada bajo demanda. Con <video> el servidor de render no atiende Range (el seek no funciona) y la conexión de medios nunca se cierra (el networkidle estalla).
Requisitos: Python 3.10+, pip install playwright + playwright install chromium (el script usa el canal chrome; cámbialo por el Chromium estándar en abrir() si no tienes Chrome instalado), ffmpeg y ffprobe en el PATH.
Archivos de esta skill:
assets/template.html: motor con reloj único, semilla fija, easings, stagger, reproductor con barra de tiempo y nombre de la escena, área segura.scripts/render.py: renderiza el MP4 cuadro a cuadro, la versión corta por fragmentos y la hoja de revisión.tecnicas.md: las 39 técnicas en 7 grupos, con los parámetros de cada una y las combinaciones por objetivo.ejemplos/reel-resultado-8s.html: pieza terminada de 8 s (número mezclado → barras → CTA con confeti), con datos de ejemplo.
Carpeta de trabajo: una carpeta por pieza (ej.: motion/<marca>/<pieza>/). El HTML, los assets (logo, fotos, fuente), el MP4 y las hojas de revisión van juntos.
Paso 0 — Kit de la marca
Monta el kit una vez por marca, a partir del manual, del sitio web o de lo que la persona envíe:
| Elemento | Cómo entra |
|---|---|
| Paleta | hex con función: fondo, texto, destacado, número. 3 a 4 colores; 7 colores es exceso de color y falta de contraste |
| Fuentes | nombre exacto. Google Fonts → <link>; fuente propia → archivo en la carpeta + @font-face |
| Logo | archivo (SVG o PNG transparente). Nunca dibujar el logo desde cero ni describirlo con palabras: sin archivo, pedirlo |
| Tono de movimiento | 2 a 3 adjetivos (tranquilo, enérgico, premium, popular) → define easing y corte |
| Números | los reales, con período y fuente. Sin número confirmado → o lo pido, o aparece en pantalla etiquetado "datos de ejemplo" |
| Oferta, CTA, @/site | del briefing. Urgencia solo con plazo real |
| Pista | archivo con licencia de la marca o de banco + BPM y segundo del drop |
Guarda el kit en motion.md dentro de la carpeta de la marca. A partir de la segunda pieza, se lee y no se vuelve a montar.
Paso 1 — Triaje: los 6 componentes
Checklist reimpreso, una pregunta por turno, elemento completado nunca reabierto, y lo que el briefing ya responda entra completado. Si falta un componente, decido yo solo, y casi siempre diferente de lo que la persona quería.
1. Formato — proporción + resolución + duración + fps
2. Escena — qué aparece, en qué orden, cuántos segundos cada una
3. Textos — las frases exactas, entre comillas (lista cerrada, literal)
4. Técnica — por el nombre (tecnicas.md)
5. Ritmo y sonido — easing, stagger, BPM / pista
6. Entrega — MP4 · versión corta de 6 s · reproductor para revisión · HTML en bucle (LP) · fondo transparente
Formato según la plataforma:
| Proporción | Resolución | Dónde se usa | Duración típica |
|---|---|---|---|
| 9:16 | 1080×1920 | Reels, Stories, TikTok, Shorts | 8–15 s, gancho en el primer cuadro |
| 4:5 | 1080×1350 | feed IG/FB | 6–15 s |
| 1:1 | 1080×1080 | feed, algunas posiciones | 6–15 s |
| 16:9 | 1920×1080 | YouTube, presentación, pantalla grande, sitio web | 5 s (vineta) hasta explicativos largos |
| LP | ancho de la página (ej.: 1440) | héroe y secciones | bucle ligero de 5–10 s, entregado como HTML |
30 fps cubre casi todo. 60 fps solo en zoom, partículas rápidas y movimiento de cámara. Pieza de anuncio: siempre una versión de 6 s con la misma firma, para prueba.
Paso 2 — Guion con minutaje (puerta)
Antes de escribir código, muestra el guion y espera aprobación:
Formato: 9:16 · 1080×1920 · 15 s · 30 fps · pista 120 BPM (cortes en 3 / 7 / 11 s)
Kit: fondo #050505 · destacado #E50914 · número #FFDD00 · Morganite / IBM Plex Sans · logo.svg
| Escena | Tiempo | Técnica | Qué sucede | Texto (literal) | Entra / sale |
Reglas del guion:
- Una idea por escena. Si la escena necesita dos frases, son dos escenas.
- 2 a 4 s por escena. Por debajo de 2 s, el texto no da tiempo de leer.
- Tiempo de lectura: 1 s por cada 3 palabras + 1 s de margen. Número solo: 1,5 s · 3 palabras: 2 s · 6 palabras: 3 s · 9 palabras: 4 s. Una frase que pide más de 4 s es demasiado larga para una escena: divide o recorta palabra (recortar palabra de copy aprobado es decisión de quien aprobó).
- Indica cómo entra y cómo sale. La salida conecta una escena con la siguiente.
- Gancho en los 3 primeros segundos en 9:16 y 4:5. El mensaje principal nunca queda para el final.
- Corte en el tiempo: tiempo = 60 ÷ BPM segundos; compás = 4 tiempos. Una escena con duración en múltiplos del compás cierra redonda (120 BPM: tiempo 0,5 s, compás 2 s · 128: 0,47 / 1,88 · 100: 0,6 / 2,4 · 90: 0,67 / 2,67).
Paso 3 — Construcción
Copia assets/template.html a la carpeta de trabajo y completa CFG, BRAND y SCENES. Leyes del código, porque de ellas depende que el MP4 salga igual a lo aprobado en el reproductor:
- Todo es función de
t. Nada desetTimeout,Date.now(), CSS transition/animation o estado acumulado entre cuadros. La letra 3 en el instante 1,4 s está siempre en el mismo lugar. - Semilla fija (
rng(CFG.SEED + i)) en todo valor aleatorio. Sin ella, lo exportado sale diferente de lo aprobado. - Simulación (física, boids, tela): fórmula analítica en
t, o precálculo en la carga a paso fijo (1/240 s), guardado por cuadro y leído por índice. Nunca integrar dentro deldraw. - Fuentes en
CFG.FONTSy assets enCFG.ASSETS: el motor espera cargar antes del primer cuadro. Una fuente que no cargó cae en genérica sin avisar, y es el error más común. - Área segura en 9:16: texto, número y logo dentro de 250 px del tope, 350 px de la base, 120 px de la derecha y 60 px de la izquierda (valores aproximados; cambian con las apps).
- Easing con intención:
inOutes el predeterminado;back(overshoot) en las entradas de texto, pines y números;linearsolo en rotación continua y desplazamiento;bouncesolo en objeto que cae. Stagger de 0,07 s entre letras y 0,15 s entre tarjetas. - Jerarquía: el número principal es el elemento más grande de la escena.
- Comentario al inicio de cada escena con el tiempo y la técnica.
Pieza larga o con técnica pesada (shader, simulación): una escena por vez. Construye, revisa y aprueba la escena antes de juntar. Pieza corta (hasta ~15 s, 4 escenas ligeras) puede nacer completa, pero la revisión continúa escena por escena.
Paso 4 — Revisión antes de mostrar
python ~/.claude/skills/motion/scripts/render.py pieza.html --sheet auto --safe
Genera la hoja con la mitad y el final de cada escena, con el área segura pintada. Lee la hoja mediante el método VER → AMPLIAR → CONFIRMAR (recorte ampliado en texto pequeño, número y logo) y pasa las 6 capas:
| Capa | Verifica |
|---|---|
| 1. Técnica | duración, resolución y fps iguales a lo solicitado; sin cuadro negro al inicio ni al final |
| 2. Marca | hex correctos; fuente de la marca cargada, no genérica; logo sin distorsión, giro o color cambiado; el tono del movimiento combina |
| 3. Lectura | una idea por escena; cada texto dura el tiempo de la regla; contraste del texto contra el fondo; el número principal es el más grande |
| 4. Plataforma | proporción correcta; nada fuera del área segura; gancho en los 3 primeros segundos; funciona sin sonido |
| 5. Datos | números iguales a los proporcionados, sin redondear; período y fuente; ejemplo etiquetado en pantalla; ningún número inventado |
| 6. Derechos | pista con licencia, de la marca o generada; fotos y pantallas autorizadas; marca de terceros solo con permiso; promesa de la oferta validada |
Para verificar un instante específico: --sheet 1.5,2.9,3.1. Si encuentro un problema, lo corrijo antes de mostrar, sin preguntar.
La 3.ª pasada del material, ver en el móvil y sin sonido, es de quien aprueba. Yo reviso cuadros, no la sensación del vídeo en movimiento. En la entrega, pide explícitamente esa pasada.
Paso 5 — Render y entrega
python ~/.claude/skills/motion/scripts/render.py pieza.html # MP4 completo
python ~/.claude/skills/motion/scripts/render.py pieza.html --segments 0-3,11-15 -o pieza_6s.mp4 # versión corta
python ~/.claude/skills/motion/scripts/render.py pieza.html --audio pista.mp3 # con pista
Después del render: ffprobe para confirmar resolución, fps, número de cuadros y duración. Entrega:
- el MP4 (H.264, yuv420p, +faststart), listo para subir;
- la versión de 6 s, si es un anuncio;
- el HTML con reproductor (se abre en el navegador: reproducir, pausa, barra de tiempo, nombre de la escena, área segura). Es en él donde quien aprueba señala el segundo exacto del ajuste.
LP: la entrega es el propio HTML en bucle, sin MP4. Ligereza primero: no debe pesar en la página.
Pista: la skill mezcla un archivo (--audio) y alinea los cortes al BPM indicado. La pista generada en código no está implementada; si la piden, dilo en lugar de improvisar. Música de terceros sin licencia tumba el anuncio: nunca usarla.
Paso 6 — Ajuste
La primera versión es un borrador. Un buen ajuste señala la escena o el segundo, dice cuánto y dice qué mantener: "En la escena 1 (0–3 s), mantén el +248% fijo 1,5 s antes de cambiar. No toques el resto." Cambio solo el fragmento afectado y re-renderizo.
| Síntoma | Causa probable | Corrección |
|---|---|---|
| Movimiento robótico | easing lineal | inOut, y back en las entradas |
| Todo entra junto | sin stagger | 0,07 s entre letras, 0,15 s entre tarjetas |
| Fuente diferente de la marca | fuente no cargó | verificar CFG.FONTS / @font-face y el archivo en la carpeta |
| Texto cortado en 9:16 | layout pensado en 16:9 | rehacer en la cuadrícula 1080×1920 respetando el área segura |
| El reproductor se traba | demasiadas partículas o shader | menos elementos en el reproductor, cuenta completa solo en el render |
| Exportado diferente del reproductor | aleatorio sin semilla o estado acumulado | leyes 1 a 3 del Paso 3 |
| Corte fuera del tiempo | escenas sin relación con el BPM | duraciones en múltiplos del tiempo |
| Número incorrecto | dato no recibido | usar exactamente la lista proporcionada, sin redondear |
Después de publicado: si la caída de retención es en los 3 primeros segundos, cambia solo la escena 1; si es en una escena del medio, acorta o cambia solo esa; si el clic no llega, prueba cierres diferentes (confeti, sello giratorio, QR) manteniendo el resto igual. Una variable por vez.
Biblioteca de la cuenta
Pieza aprobada → en el motion.md de la marca, registra: el guion aprobado, las técnicas usadas, la ruta del HTML y, cuando estén disponibles, las métricas de los primeros 7 días. La próxima pieza comienza desde lo que ya funcionó, y el cierre estándar de la marca (firma final con logo + CTA) se reutiliza, no se rehace.