Video de producto
Crea un video de presentación del producto con música, sin locución, construido como una animación HTML y renderizado fotograma a fotograma a MP4. Cada número, nombre y diagrama proviene de la salida real del producto. Eso es lo que le da credibilidad y lo diferencia de los gráficos animados genéricos.
Cómo funciona: una sola página HTML en la resolución objetivo define window.seek(t), que dibuja el fotograma en el tiempo t como una función pura (sin animaciones CSS, sin temporizadores). Playwright llama a seek(i/30) y captura cada fotograma, y los fotogramas se envían a ffmpeg. Como los fotogramas no dependen del tiempo real, la salida es idéntica en cualquier máquina, puedes previsualizar cualquier fotograma individual y los cambios se renderizan en minutos.
Archivos incluidos:
scripts/render.mjs: composición a MP4 (--url --out [--w --h --fps --from --to])scripts/preview.mjs: imágenes fijas en momentos elegidos, más--sheetpara una tira de contactosscripts/cutdown.py: reels cortos (p.ej., 15s) cortados de una composición existente: renderiza los rangos de tiempo elegidos, los une con cortes duros y coloca el drop de la música en el primer cortescripts/cues.mjs: deriva una lista de señales de efectos de sonido de la composición (whooshes de escena, pops de tarjetas/chips, tics de contadores, clics de cursor, el timbre de la URL, máswindow.SFX_EXTRA)scripts/sfx.py: sintetiza el kit de sonido de interfaz desde cero (clic, pop, whoosh, tic, tecla, timbre, golpe; sin audio comercial ni licencias), mezcla las señales en una pista y realiza la mezcla final de música + efectos a -16 LUFSscripts/music.py: analiza el mapa de energía de una pista y la multiplexa debajo del video (recorte, fundido, -16 LUFS)scripts/doctor.mjs: verifica todos los requisitos a continuación e imprime la solución exacta para cualquier cosa que faltescripts/_common.mjs: encuentra un Chromium y ffmpeg preinstalados (alternativa pipimageio-ffmpeg)assets/template.html: una plantilla de escena funcional; un archivo renderiza 16:9 y 9:16 a través de una consulta de medios para orientación verticalassets/fonts-manrope.css: fuente Manrope incrustada (alternativa si el producto no tiene una fuente incrustada)assets/examples/supersnapshot/: (Super Snapshot AI, una herramienta de GoHighLevel) el código fuente completo de un video de 80s (16:9 + vertical), un ejemplo completo de cada patrón con calidad de producciónreferences/story-and-copy.md: el arco narrativo, reglas de titulares, reglas de honestidad, convenciones de sincronización. Léelo antes de hacer el storyboard.references/extraction.md: cómo encontrar una fuente de datos segura y extraer SVGs, gráficos y capturas de pantalla del producto. Léelo antes de capturar.
Requisitos
El skill ejecuta comandos de shell, por lo que necesita Claude Code (CLI, aplicación de escritorio o Claude Code en la web). Un chat sin entorno de código puede planificar un storyboard pero no puede renderizar. En la máquina o contenedor:
| Necesita | Por qué | Instalar |
|---|---|---|
| Node.js 18+ | ejecuta los scripts de renderizado | nodejs.org o nvm install 22 |
Paquete npm playwright, importable desde el directorio de trabajo | controla el navegador fotograma a fotograma | npm i -D playwright (muchos repositorios web ya lo tienen) |
| Chromium | renderiza los fotogramas | npx playwright install chromium, o reutiliza uno preinstalado (CHROME=/path; /opt/pw-browsers se encuentra automáticamente) |
Python 3.9+ con numpy | síntesis y mezcla de efectos de sonido | pip install numpy |
| ffmpeg | codificación, música, mezcla | ffmpeg del sistema, o pip install imageio-ffmpeg |
El acceso a la red solo es necesario para instalar estos componentes. El renderizado es totalmente offline. El usuario proporciona su propia pista musical; los efectos de sonido se sintetizan, por lo que no hay nada que licenciar.
Flujo de trabajo
0. Verificar la configuración
Desde el repositorio del producto, ejecuta node <skill>/scripts/doctor.mjs. Si algo muestra ✗, ejecuta la solución impresa (o pídele al usuario que lo haga, si no puedes instalar paquetes en este entorno) antes de comenzar. Encontrar que falta ffmpeg después de una compilación de 30 minutos desperdicia toda la sesión.
1. Encontrar el material real
Lee references/extraction.md. Localiza una compilación de demostración/ejemplo del producto (scripts del repositorio, fixtures o una URL de ejemplo pública), ábrela en Playwright, haz clic en cada pestaña y vuelca el texto de cada panel. Captura la pantalla de los paneles y míralos. Buscas: el número real más impactante (el gancho), las características por las que un comprador pagaría y los elementos visuales que se ven bien en movimiento.
2. Storyboard, luego obtener la aprobación
Lee references/story-and-copy.md. Propón una tabla: # · tiempo · qué hay en pantalla · subtítulo en pantalla. Mantén la duración entre 60 y 75s (o 30–45s para un corte social). Di honestamente qué características se ven débiles en cámara. Pregunta solo las pocas cosas que solo el usuario puede responder, y nada más:
- algo que evitar mencionar,
- el CTA (por defecto: solo la URL),
- el aspecto de la marca (por defecto: que coincida con los tokens del producto).
Espera su aprobación antes de construir, porque volver a cortar un renderizado terminado cuesta mucho más que editar una tabla.
3. Capturar los activos
Coloca todo en un directorio de trabajo temporal fuera del repositorio del producto (el bloc de notas de la sesión si lo tiene, si no, un directorio temp): <work>/index.html + <work>/assets/. Extrae los SVGs de diagramas, el JSON de gráficos y las capturas de pantalla largas de informes como se describe en extraction.md. Copia el CSS de la fuente incrustada del producto a assets/fonts.css (o assets/fonts-manrope.css de este skill).
4. Construir la composición
Copia assets/template.html a <work>/index.html. Reemplaza cada marcador de posición [BRACKETED] con contenido real, elimina las escenas que no necesites y duplica las que sí. Echa un vistazo al ejemplo en assets/examples/supersnapshot/index.html para más patrones (tarjetas de "problema" cálidas, tarjeta de barra con cuadro de llamada, dial de puntuación, mapa de dependencias radial, red de toda la cuenta, filas de correcciones con etiquetas de gravedad).
Cosas que importan:
- La sincronización vive en dos lugares: los tiempos de inicio de
SCENESy eldata-inde cada elemento. Si insertas una escena, desplaza cadadata-inposterior y cualquier tiempo hardcodeado enseek()en la misma cantidad (una pequeña expresión regular sobre los valoresdata-in="…"≥ el punto de inserción lo hace). - Crossfades: la nueva escena se funde sobre la antigua, que permanece sólida debajo. Fundir ambas a la vez hace que las escenas claras se vuelvan un gris turbio.
- Revelaciones: las partes SVG aparecen en orden de lectura (de arriba a abajo, o del centro hacia afuera). Las puntas de flecha aparecen solo una vez que su línea ha aterrizado. Resalta un nodo por su texto de etiqueta.
- Llamadas: los chips y las etiquetas nunca deben cubrir lo que señalan. Colócalos en el espacio vacío a su lado, y haz que lo sigan si la cámara se desplaza.
5. Previsualizar antes de renderizar
Sirve el directorio (cd <work> && python3 -m http.server 8765 &) y renderiza imágenes fijas en el momento clave de cada escena:
node <skill>/scripts/preview.mjs --url http://127.0.0.1:8765/index.html --dir <work>/prev --sheet 5 9 13 22 31 43 50 60
Mira cada fotograma. Verifica superposiciones, saltos de línea incómodos (fuérzalos con <br>), elementos que aparecen antes de lo que señalan, tarjetas vacías y texto de marcador de posición que haya quedado. Corrige y vuelve a previsualizar hasta que esté limpio. Los scripts necesitan playwright: ejecútalos desde un directorio cuyo node_modules lo tenga (el repositorio del producto normalmente lo tiene). También encuentran un Chromium preinstalado por sí solos, así que no ejecutes playwright install.
6. Renderizar y verificar
node <skill>/scripts/render.mjs --url http://127.0.0.1:8765/index.html --out <work>/video.mp4
Aproximadamente de 3 a 5 minutos para 80s a 1080p30. Después, extrae fotogramas del propio MP4 en las transiciones de escena (ffmpeg -ss <t> -i video.mp4 -frames:v 1 x.jpg) para detectar problemas de transición que las imágenes fijas individuales pasan por alto.
7. Música
Cuando el usuario envíe una pista:
python3 <skill>/scripts/music.py analyze track.mp3 # encontrar la intro, el drop, los breakdowns
python3 <skill>/scripts/music.py analyze track.mp3 --zoom 14 17 # fijar el drop al ritmo
python3 <skill>/scripts/music.py mux video.mp4 track.mp3 out.mp4 [--offset s]
El objetivo es que el drop caiga en el corte desde la revelación de la marca hasta la primera escena de características. Elige --offset (o ajusta SCENES) para lograrlo. Dile al usuario dónde caen los segmentos tranquilos. Si una escena de venta clave se encuentra en un breakdown, sugiere reordenar las escenas.
7b. Cursor y efectos de sonido
Hacen que el video se sienta como un producto real en uso, pero solo cuando cada sonido tiene algo en pantalla que lo causa.
Cursor: la lista CURSOR de la plantilla define de 2 a 4 momentos de clic. El cursor se desliza hacia un elemento real (por selector CSS, medido en cada fotograma, por lo que sigue los desplazamientos y funciona en ambas orientaciones), presiona y deja una onda. Cada clic debe causar lo que sigue aproximadamente 0.1–0.3s después: las barras se llenan, un paso se resalta, un mapa se despliega, comienza la escritura. Mueve el data-in de la reacción si es necesario. Verifica en las previsualizaciones que el objetivo ya haya aparecido cuando se hace clic; hacer clic en un nodo que aún no se ha dibujado se ve mal. Si un objetivo no tiene un selector útil, asígnale un id en init() (p.ej., encuentra un nodo de mermaid por su texto de etiqueta).
Sonidos:
node <skill>/scripts/cues.mjs --url http://127.0.0.1:8765/index.html --out <work>/cues.json
python3 <skill>/scripts/sfx.py mix <work>/cues.json --duration <DURACION> --out <work>/sfx.wav
python3 <skill>/scripts/sfx.py final <work>/video.mp4 --sfx <work>/sfx.wav --music track.mp3 [--offset s] --out <work>/final.mp4
cues.mjs coloca los sonidos a partir de la propia sincronización de la animación, por lo que permanecen bloqueados a ella después de cualquier cambio de tiempo. Cualquier cosa que no pueda ver (contadores impulsados por JS en lugar de data-count, escritura, un gancho que aterriza) va en window.SFX_EXTRA. Mantenlo escaso: sin sonido en las entradas de titulares, una sola ejecución de tic por grupo de contadores. Las ganancias que funcionaron contra una pista corporativa ocupada: clic aproximadamente -1 dB, tecla aproximadamente -6, tic aproximadamente -8, pop -11, whoosh -10 a -14. Para comprobar que un sonido no queda enterrado, compáralo con la música en la banda >2.5 kHz (pasa ambos por un filtro de paso alto, compara los picos); los picos de banda completa engañan porque el bajo de la música domina. Si los efectos se sienten enterrados, baja --music-gain (por defecto -6) antes de subir las ganancias de los efectos. final ajusta el volumen con una sola ganancia estática, ya que un loudnorm dinámico aplastaría los clics. sfx.py kit <dir> escribe cada sonido como un WAV para audicionar.
8. Vertical 9:16
La plantilla es consciente de la orientación: renderiza la misma página con --w 1080 --h 1920 y la consulta de medios para orientación vertical toma el control (los titulares se apilan sobre tarjetas de ancho completo, el contenido clave se mantiene entre y≈250 e y≈1550, lejos de las superposiciones de las aplicaciones sociales). Usa <br class="br-v"> para saltos de línea que solo deben ocurrir en orientación vertical. Para una composición que no se haya creado a partir de la plantilla (como el ejemplo), haz una copia vertical.html con posiciones verticales. Previsualiza también los fotogramas verticales, ya que el texto se ajusta de manera diferente.
9. Reels cortos (15s)
Una vez que exista el video vertical, corta de 2 a 4 reels cortos a partir de él. Cada uno tiene un ángulo (un problema, un grupo de características), por lo que cada uno puede probarse como un anuncio o publicación independiente. No reconstruyas nada: elige rangos de tiempo de la composición vertical y deja que cutdown.py los renderice y los una.
python3 <skill>/scripts/cutdown.py --url http://127.0.0.1:8765/vertical.html \
--seg 3.2-6.2 --seg 6.5-9.0 --seg 15.4-20.9 --seg 75.6-79.6 \
--out <work>/reel1.mp4 --music track.mp3 --drop 15.0 --sfx
--sfx extrae las señales de sonido de cada segmento de la composición, las re-sincroniza para el reel y las mezcla con la música.
Elegir segmentos (consulta "Reels cortos" en references/story-and-copy.md):
- Forma: gancho (2.5–3s) → 1–2 golpes de característica (4–5.5s cada uno) → tarjeta final (4s). Total 15s.
- Comienza cada segmento después de que su escena se haya fundido por completo (inicio de escena + aproximadamente 0.5s) o en una entrada clave, y termínalo después de que su recompensa haya aterrizado: contadores terminados, el chip haya aparecido, el resaltado esté iluminado. Verifica los tiempos
data-in/de conteo en la composición. Un contador cortado a la mitad es el error clásico. - Comienza el segmento de la tarjeta final aproximadamente 0.6s después de que aparezca el logotipo, para que la URL esté en pantalla durante 3s o más.
- Mantén cada longitud de segmento como un múltiplo del ritmo (0.5s a 120 BPM) para que todos los cortes caigan en el ritmo, y pasa
--droppara que el drop golpee el primer corte. - El primer fotograma de un reel ya debe mostrar el gancho. No hay tiempo para un fundido de entrada lento.
Después de renderizar, extrae un fotograma de la mitad y del final de cada segmento en el MP4 terminado y míralos. Luego dile al usuario qué reel publicar primero (el que se abre con un problema), cuáles son solo para audiencias cálidas (solo atractivo visual sin problema), y que la letra pequeña no será legible a este ritmo, por lo que el gancho también debe ir en el pie de foto de la publicación.
10. Entregar
Envía los archivos MP4 al usuario. Luego da una crítica honesta: duración total (80s es largo; 30–45s es mejor para Reels/Shorts), la escena más débil y un corte o reordenamiento concreto. Ofrece los siguientes pasos: corte vertical, reels de 15s, música, recortes. No confirmes archivos de video ni fuentes de compilación en el repositorio del producto a menos que te lo pidan.
Lista de verificación de entrega
- Cada número/nombre en pantalla coincide con la salida real del producto
- Nada de lo que el usuario pidió omitir aparece en ninguna parte
- No queda texto
[marcador de posición], ni elementos recortados o superpuestos en ningún fotograma previsualizado - El número del gancho cuenta en los primeros 5s; la URL está en pantalla durante al menos 3s al final
- Las transiciones se verificaron en el MP4 codificado, no solo en imágenes fijas
- La música (si la hay) está recortada, con fundido de salida, normalizada y su drop cae en un corte de escena
- Cada clic del cursor aterriza en un elemento que ya es visible y causa algo
- Los clics, las teclas y los tics son audibles sobre la música (verifica la banda >2.5 kHz), y la mezcla final es -16 LUFS
- Reels: cada segmento termina después de su recompensa (sin contadores a medias), la URL se muestra durante 3s o más, los cortes caen en los ritmos