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 enfonts.json;CONFIG.fontnombra una de esas familias primero.python3 build.pylas 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> --sheetpara 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.