Communitygithub.com

Saucemathis/marketing-video-skill

Crea un video promocional terminado para cualquier marca o producto en un estilo de diseño de movimiento preciso: una forma de UI que se transforma, un cursor real, resortes, una cámara que hace zoom, una banda sonora sincronizada con el ritmo, renderizado a MP4 desde código.

¿Qué es marketing-video-skill?

Esta skill de Claude Code permite crear videos promocionales de alto nivel, completamente renderizados a MP4, para lanzamientos de productos, anuncios de funciones o loops para redes sociales, todo desde una sola página HTML donde cada píxel es una función pura del tiempo (`seek(t)`). Está diseñada para cualquier persona, no solo diseñadores: la habilidad recopila el contexto del usuario (tema, capturas de pantalla de UI, sistema de diseño, un video de inspiración) y construye el video en un estilo de motion design preciso que incluye una forma de UI que se transforma continuamente, un cursor real animado con resortes físicos, una cámara que hace zoom y una banda sonora sincronizada al milisegundo. El flujo de trabajo es iterativo: el usuario proporciona primero la inspiración y los elementos de la marca, la skill analiza el video de inspiración (ritmo de cortes, tempo musical, movimientos de cámara), genera una tabla detallada estado por estado en una cuadrícula de beats, y solo tras la aprobación construye, verifica y renderiza. Soporta múltiples formatos (1:1, 9:16, 16:9) y permite mezclar música y voces reales. La skill requiere Node 18+, ffmpeg, Python 3 con numpy y Playwright; todo se instala y verifica automáticamente. Los scripts incluidos garantizan que cada clic en el video esté dentro de los botones y que el texto sea legible incluso en pantallas pequeñas, y las entregas finales se versionan para evitar sobrescrituras. En resumen, transforma una idea y unos pocos activos en un video promocional pulido, con un control absoluto sobre cada fotograma y sonido.

Compatible con~Claude Code~Codex CLI✓Cursor
npx skills add Saucemathis/marketing-video-skill

Preguntar en tu IA favorita

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

Documentación

Video promocional

El video es una sola página HTML donde cada píxel es una función pura del tiempo, seek(t), renderizada fotograma a fotograma con desenfoque de movimiento y una banda sonora colocada al milisegundo. Todo lo específico de una marca proviene de la recopilación de información; no se asume nada. Habla con la persona en su idioma. SKILL_DIR a continuación es la carpeta que contiene este archivo.

0. Primera ejecución: las herramientas

bash SKILL_DIR/scripts/check_deps.sh

Enumera lo que le falta a esta máquina (node 18+, ffmpeg, python3, numpy) con los comandos de instalación para su sistema. Si falta algo, dile a la persona en palabras simples para qué sirve cada herramienta, muéstrale los comandos y pregúntale una vez si desea instalarlos. Instala solo si la respuesta es afirmativa y luego vuelve a ejecutar la verificación. Un comando que requiera su contraseña o que abra su propio instalador (Homebrew, sudo) es uno que la persona ejecuta en su propia terminal; entrégaselo y espera. Mientras tanto, haz las preguntas de la recopilación inicial: nada más depende de las herramientas hasta el paso 2.

1. Recopilación inicial: pregunta todo primero

Envía las preguntas de references/intake.md en un solo mensaje. Obligatorio antes de construir cualquier cosa:

  • el tema: qué dice el video, a quién, dónde se publicará;
  • un video de inspiración: la entrada más útil de todas;
  • el sistema de diseño, o permiso explícito para usar valores neutrales por defecto;
  • capturas de pantalla de la UI cada vez que el video muestre un producto.

Cada entrada debe terminar como un archivo local: pide una descarga, o búscala tú mismo cuando una herramienta lo permita. Todo lo demás tiene un valor predeterminado establecido. Si un elemento requerido aún falta después de un recordatorio, no inicies nada que dependa de él; para la inspiración solo, ofrece el estilo propio del motor (una forma que se transforma continuamente) y continúa una vez que la persona lo acepte.

Crea el proyecto y luego registra las respuestas en su brief.md:

bash SKILL_DIR/scripts/setup.sh ~/marketing-videos/<slug>    # plantilla, scripts, Playwright local
cd ~/marketing-videos/<slug>                                 # todos los comandos posteriores se ejecutan desde aquí

2. Lee la inspiración y confirma la lectura

python3 inspect_inspiration.py <video>      # hojas de contacto, cortes, duración de tomas, tempo musical

Mira ambas hojas y luego escribe una lectura de estilo de diez líneas como máximo: transformación continua o cortes, eventos por beat y cuánto tiempo se mantienen los estados, movimientos de cámara, easing, paleta, tipografía, sonido. Muéstrala y pregunta qué conservar. Una dirección escrita de la persona (reglas, una lista prohibida, una estructura) anula la lectura. Si la persona proporcionó música, mídela ahora (python3 inspect_inspiration.py track.mp3) y establece CONFIG.bpm a su tempo antes de la cuadrícula.

3. La lista de estados en la cuadrícula de beats, luego espera

Una tabla con una fila por beat: tiempo, estado en pantalla, cómo se mueve, qué hace el cursor, cámara. references/craft.md da las reglas. No construyas nada hasta que la persona lo apruebe. Iterar aquí cuesta un minuto; después de la construcción cuesta una hora.

4. Construcción

Edita scene.html: CONFIG (tempo, compases, loop o tarjeta final, tokens, fuentes), luego reemplaza la escena de ejemplo. Lee references/craft.md primero: posee el motor, las reglas de movimiento y los detalles importantes.

  • Fuentes: coloca los archivos de la marca en fonts/ (descarga Google Fonts como woff2) y listalos en fonts.json; CONFIG.font nombra una de esas familias primero. python3 build.py las incrusta.
  • Logotipo: pega el SVG de la marca tal cual. Nunca vuelvas a escribir un logotipo con una fuente.
  • Las capturas de pantalla son una referencia para una recreación simplificada en HTML, nunca pegadas como imágenes.
  • Metraje real: python3 frames.py --src clip.mp4 --name <quien> --sheet para seleccionar una ventana limpia, luego extráelo recortado a la relación de aspecto del fotograma. El metraje se reproduce en silencio a menos que su sonido se mezcle en el paso 5.

5. Verifica, luego el sonido

python3 build.py && node preview.mjs     # hoja de contacto por formato, un fotograma por beat, errores de consola y fuentes
node checks.mjs                          # clics dentro de sus botones, el puntero nunca sobre texto leído

Ambos por defecto a 1440x1440 y 1080x1920; pasa otros tamaños como 1920x1080. Lee cada hoja y corrige lo que esté fuera de la cuadrícula, apretado, ilegible en tamaño de teléfono, o a medio camino de una transición cuando debería haber terminado. checks.mjs debe pasar en cada formato; declara cada nuevo clic y cada texto a proteger en window.CHECKS.

python3 audio.py luego sintetiza una base en el tempo de la escena y coloca cada sonido de window.CUES por su pico medido. --music track.mp3 --offset <s> usa la pista de la persona; --voice clip.mp4:at:start:dur mezcla la voz de una persona filmada y baja la música debajo de ella.

6. Renderiza y entrega

node render.mjs scene.built.html 1440 1440 out/<slug>-v1-1x1.mp4 audio/bed.wav
node render.mjs scene.built.html 1080 1920 out/<slug>-v1-9x16.mp4 audio/bed.wav

Cada versión entregada recibe nuevos nombres de archivo, y sus fuentes se copian a versions/v<N>/ en el momento de la entrega. Nunca sobrescribas un archivo entregado hasta que el nuevo render haya terminado. Copia los MP4 donde la persona quiera e informa qué cambió, qué verificaciones pasaron y cualquier decisión subjetiva que se haya tomado en su nombre.

7. Iterar

Sigue craft.md#iterating: cambia solo lo que se nombró, estira el tiempo en lugar de re-coreografiar, vuelve a ejecutar preview.mjs y checks.mjs después de cada cambio.

Requisitos

La carpeta es autocontenida. Los scripts necesitan node 18+, ffmpeg y python3 con numpy (el paso 0 encuentra e instala lo que falta); setup.sh agrega Chromium de Playwright en cada proyecto. Si el proyecto vive en un repositorio con sus propias reglas, síguelas y mantén los renders, metraje, fotogramas y node_modules fuera del control de versiones.

Skills relacionados