Communitygithub.com

motion

Crea motion graphics escribiendo código y entrega el MP4 listo: reel 9:16, video 16:9, anuncio corto, vineta, animación de LP. Escribe la animación en HTML/Canvas con un reloj único, renderiza cuadro a cuadro en el ordenador (Playwright + ffmpeg) y revisa mediante una hoja de cuadros antes de entregar.

¿Qué es motion?

Esta skill te permite crear motion graphics profesionales escribiendo código puro en HTML/Canvas, garantizando precisión absoluta en colores hex, tipografía de marca y números. En lugar de usar generadores de vídeo por IA o editores visuales, escribes un programa que dibuja cada cuadro a partir de un reloj `t`, lo renderizas cuadro a cuadro con Playwright y ffmpeg, y obtienes un MP4 listo para publicar. Es ideal para reels, anuncios cortos, vinetas de marca, animaciones para landing pages y cualquier pieza que requiera exactitud técnica. Soporta formatos 9:16, 16:9, 4:5, 1:1 y LP, permite integración de vídeo real como secuencia de cuadros, y ofrece un sistema de revisión por hojas de cuadros para detectar errores antes de la entrega final. No sirve para filmar, fotografía realista ni generación de vídeo por IA a partir de imágenes.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/arthurmkt/arthur-portfolio-mkt/tree/main/design/motion

Preguntar en tu IA favorita

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

Documentación

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:

ElementoCómo entra
Paletahex con función: fondo, texto, destacado, número. 3 a 4 colores; 7 colores es exceso de color y falta de contraste
Fuentesnombre exacto. Google Fonts → <link>; fuente propia → archivo en la carpeta + @font-face
Logoarchivo (SVG o PNG transparente). Nunca dibujar el logo desde cero ni describirlo con palabras: sin archivo, pedirlo
Tono de movimiento2 a 3 adjetivos (tranquilo, enérgico, premium, popular) → define easing y corte
Númeroslos reales, con período y fuente. Sin número confirmado → o lo pido, o aparece en pantalla etiquetado "datos de ejemplo"
Oferta, CTA, @/sitedel briefing. Urgencia solo con plazo real
Pistaarchivo 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ónResoluciónDónde se usaDuración típica
9:161080×1920Reels, Stories, TikTok, Shorts8–15 s, gancho en el primer cuadro
4:51080×1350feed IG/FB6–15 s
1:11080×1080feed, algunas posiciones6–15 s
16:91920×1080YouTube, presentación, pantalla grande, sitio web5 s (vineta) hasta explicativos largos
LPancho de la página (ej.: 1440)héroe y seccionesbucle 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:

  1. Todo es función de t. Nada de setTimeout, 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.
  2. Semilla fija (rng(CFG.SEED + i)) en todo valor aleatorio. Sin ella, lo exportado sale diferente de lo aprobado.
  3. 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 del draw.
  4. Fuentes en CFG.FONTS y assets en CFG.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.
  5. Á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).
  6. Easing con intención: inOut es el predeterminado; back (overshoot) en las entradas de texto, pines y números; linear solo en rotación continua y desplazamiento; bounce solo en objeto que cae. Stagger de 0,07 s entre letras y 0,15 s entre tarjetas.
  7. Jerarquía: el número principal es el elemento más grande de la escena.
  8. 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:

CapaVerifica
1. Técnicaduración, resolución y fps iguales a lo solicitado; sin cuadro negro al inicio ni al final
2. Marcahex correctos; fuente de la marca cargada, no genérica; logo sin distorsión, giro o color cambiado; el tono del movimiento combina
3. Lecturauna 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. Plataformaproporción correcta; nada fuera del área segura; gancho en los 3 primeros segundos; funciona sin sonido
5. Datosnúmeros iguales a los proporcionados, sin redondear; período y fuente; ejemplo etiquetado en pantalla; ningún número inventado
6. Derechospista 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íntomaCausa probableCorrección
Movimiento robóticoeasing linealinOut, y back en las entradas
Todo entra juntosin stagger0,07 s entre letras, 0,15 s entre tarjetas
Fuente diferente de la marcafuente no cargóverificar CFG.FONTS / @font-face y el archivo en la carpeta
Texto cortado en 9:16layout pensado en 16:9rehacer en la cuadrícula 1080×1920 respetando el área segura
El reproductor se trabademasiadas partículas o shadermenos elementos en el reproductor, cuenta completa solo en el render
Exportado diferente del reproductoraleatorio sin semilla o estado acumuladoleyes 1 a 3 del Paso 3
Corte fuera del tiempoescenas sin relación con el BPMduraciones en múltiplos del tiempo
Número incorrectodato no recibidousar 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.

Individual skills in this repo

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

Skills relacionados