Video demo de navegador
Escribes el video como código, por lo que las tomas son repetibles: un cambio de voz o una etiqueta corregida significa una nueva toma automática, no una regrabación manual. El pipeline:
script.cjs ──tts.cjs──▶ audio/*.wav + durations.json
│ │
└──────────record.cjs◀───────────┘ Chrome + overlay, CDP screencast → takes/<target>/frames + timeline.json
│
post.py ──▶ MP4 (cortes eliminados, narración + clics, −16 LUFS, capítulos)
│
review.py ──▶ hojas de contacto + verificación de volumen/capítulos → tú inspeccionas, luego entregas
Motor: scripts/ en esta skill. Proyecto por video: ~/Movies/Demos/<slug>/ (nunca /tmp, que se borra), que contiene video.config.cjs, script.cjs, audio/ y takes/. Ejemplo ejecutable: examples/hello-orders/ (una pequeña página incrustada en un shell anfitrión; úsalo para verificar tu configuración). Lee references/lessons.md antes de la primera toma.
Requisitos: Chrome, Node con Playwright (record.cjs lo encuentra, o configura playwright en la configuración), ffmpeg/ffprobe, Python 3 y AWS CLI para Polly.
1. Acordar el video (antes de cualquier código)
Confirma y propón un esquema al que el usuario pueda reaccionar:
- Audiencia. Los videos internos cubren roles, permisos, controles y límites conocidos, y terminan con un capítulo "Cosas que saber". Los videos para liderazgo y clientes cubren resultados y solo el camino feliz.
- El flujo completo, como capítulos, y la duración objetivo. Unos 10–12 minutos funcionaron bien para una inmersión profunda interna.
- Dónde grabar (decisión). El walkthrough hace clic en botones reales y escribe estado real, por lo que nunca se ejecuta en datos reales compartidos. Recomienda una copia, un espacio de trabajo de prueba o un entorno de desarrollo con datos realistas, más una forma de restablecerlo entre tomas. Si hacer esa copia escribe en producción, necesita un sí explícito.
- Identidades (decisión). Si el flujo necesita dos personas (creador y revisor), un compañero real inicia sesión en una segunda ventana, o una persona interpreta ambos roles y el video lo indica en pantalla. Nunca crees usuarios ni manejes contraseñas; si se necesita una cuenta de prueba, el usuario la crea.
- Voz (decisión). La opción predeterminada es Polly generativa "Amy" (en-GB), que funcionó bien con usuarios reales. Ofrece una muestra de ~30 s de cada voz candidata antes de generar todo:
aws polly synthesize-speech --profile <perfil de desarrollo> --region eu-west-2 --engine generative --voice-id Amy --output-format mp3 --text "<pasaje con la jerga del producto>" sample-Amy.mp3Usa una cuenta de AWS que no sea de producción. macOSsayfunciona sin conexión pero suena sintético. La propia voz del usuario es la opción más natural. - Encuadre. Solo el producto está en el marco: sin paneles laterales del anfitrión, listas ni banners. Configura esto en el hook
setupde la configuración.
2. Configurar el proyecto
P=~/Movies/Demos/<slug>; K=~/.claude/skills/browser-demo-video
mkdir -p "$P" && cp $K/templates/video.config.cjs $K/templates/script.cjs "$P"/
En video.config.cjs, completa: la url del entorno desechable, frame si el producto se ejecuta en un iframe, ready, setup (encuadre), theme (color de acento del producto y pie de página), voice y helpers.waitLoaded (la señal de carga del producto).
Mapea la interfaz antes de escribir los pasos. Ábrela, lista selectores estables (ids, roles, data-*, texto visible) y anota cargas lentas. Prefiere selectores basados en texto mostrado (tr:has-text("-1,250.00") [data-resolve]) sobre claves generadas.
3. Escribir el guión de la escena
Cada paso tiene { id, chapter?, pre?, say?, act?, gap? }. La API h está documentada al inicio de templates/script.cjs.
- La narración marca el tiempo.
actse ejecuta mientras se reproduce el clip, yh.at(0.6)alinea una segunda acción con las palabras. Mantén cadasayen una o dos oraciones habladas. - Escribe los números como se pronuncian ("noventa y siete por ciento", "el catorce de septiembre").
- Usa decisiones reales de usuarios reales cuando existan, para que las cifras en pantalla coincidan con lo que el equipo conoce.
- Pon una tarjeta de capítulo (
h.card) antes de cada capítulo, y añade anillos con etiquetas de 3 a 6 palabras. Usanote()solo donde sea necesario señalar un punto, como una propiedad de seguridad, una advertencia o "en uso real…". - Envuelve cada carga lenta en
h.cut(() => h.waitLoaded(), 'Cargando …'). Ese lapso se elimina en la postproducción. - Di cada simplificación en pantalla y en la narración. Por ejemplo, una persona interpreta dos roles: muestra el control que lo impide, muestra el ajuste que se cambia "solo para esta grabación", luego explica qué sucede en uso real.
- Apunta a las descargas; no hagas clic en ellas (ver lecciones).
4. Generar la voz en off
node $K/scripts/tts.cjs "$P". Solo se regeneran las líneas cambiadas. Claude no puede escuchar el resultado, así que nombra las palabras riesgosas (acrónimos, nombres) y pide al usuario que las verifique. Con macOS say, deletrea los acrónimos como letras ("S A P").
5. Ensayo, luego inicio de sesión, luego grabación
- Ensayo. Apunta
TARGET=previewconpreviewUrla una compilación local si existe. De lo contrario, ejecuta segmentos cortos en el entorno desechable:ONLY='^(c1|load0|where1)$' node $K/scripts/record.cjs "$P" record. Revisa algunos fotogramas con la herramienta Read (takes/prod/frames/*.jpg,failure.pngen errores) y verifica con ffprobe que los fotogramas sean 1920×1080. Restablece el entorno después. - Inicio de sesión. Ejecuta
node $K/scripts/record.cjs "$P" loginconrun_in_background. El usuario inicia sesión en la ventana que se abre, luego la cierra. Si dice que ha terminado pero la ventana sigue abierta,pkill -INT -f "record.cjs.* login". - Toma completa. Restablece el entorno, luego ejecuta
node $K/scripts/record.cjs "$P" recordconrun_in_background. Antes de que comience, dile al usuario que tomará aproximadamente la duración de la narración más un tercio, en una ventana visible de Chrome en la que no debe hacer clic. Espera la notificación de finalización; no hagas polling con sleep. Revisa el registro por cada pasooky ninguna líneaFAILEDoCRASHED.
6. Ensamblar y revisar
python3 $K/scripts/post.py "$P/takes/prod" "$P/takes/prod/walkthrough.mp4" # run_in_background; ~10 min para un video de 10 min
python3 $K/scripts/review.py "$P/takes/prod" "$P/takes/prod/walkthrough.mp4" "$P/review" # opcional: step_id:0.8 picks
Lee cada hoja review/s*.jpg. Busca etiquetas recortadas o superpuestas, anillos en el elemento incorrecto, estados de carga que no se eliminaron y superposiciones sobrantes. El volumen debe ser aproximadamente −16 LUFS y el número de capítulos debe coincidir con el guión. Corrige los problemas en el guión, restablece el entorno y vuelve a grabar. Las nuevas tomas son económicas.
7. Entregar y limpiar
- Entrega. Copia el video a
$P/<slug>.mp4y ejecutaopen. Si existe una versión anterior, consérvala renombrada (por ejemplo,old-<voice>-<slug>.mp4), no sobrescrita. - Informe. Proporciona la duración, resolución, capítulos, la voz, dónde se grabó, cada simplificación mostrada, lo que no pudiste verificar (el audio) y cualquier defecto visual restante.
- Pregunta antes de limpiar. Obtén la aprobación del usuario antes de eliminar la copia o el entorno desechable, y antes de borrar
takes/(los fotogramas ocupan GBs). Conservascript.cjs, la configuración yaudio/para que el video se pueda volver a grabar más tarde. - Regístralo. Si el trabajo pertenece a un ticket o archivo de notas, anota allí la ubicación del video y que la eliminación de la copia está pendiente. Confirma solo ese archivo.