Communitygithub.com

rnijhara/claude-skills

Produce un video demo narrado y con capítulos en 1080p MP4 de cualquier producto basado en navegador (web app, dashboard, herramienta interna, artefacto integrado).

¿Qué es claude-skills?

Esta skill permite generar videos demo o walkthrough narrados y con capítulos en 1080p MP4 para cualquier producto basado en navegador. Conduce la interfaz real en Chrome usando un cursor en pantalla, anillos de resalte, notas y tarjetas de título, vocaliza un guión de escena con TTS (Amazon Polly o macOS say), sincroniza cada acción con la narración, elimina tiempos de carga y mezcla, normaliza y añade capítulos al resultado. Está diseñada para desarrolladores y agentes de IA que necesitan crear videos de demostración, recorridos de producto o screencasts con voz en off de forma repetible y programática. Soporta plataformas como Claude Code, Cursor y Codex, y se basa en archivos de configuración y scripts en Node.js, Python y Playwright. El flujo de trabajo incluye escritura de guión como código, generación de voz, grabación en Chrome, post-procesado y revisión, todo orquestado desde la línea de comandos. Es útil para equipos de producto, documentación técnica o demostraciones internas, ya que permite rehacer la grabación automáticamente si cambia la voz o una etiqueta, sin necesidad de regrabar manualmente.

Compatible con✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/rnijhara/claude-skills/tree/HEAD/plugins/browser-demo-video/skills/browser-demo-video

Preguntar en tu IA favorita

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

Documentación

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.mp3 Usa una cuenta de AWS que no sea de producción. macOS say funciona 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 setup de 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. act se ejecuta mientras se reproduce el clip, y h.at(0.6) alinea una segunda acción con las palabras. Mantén cada say en 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. Usa note() 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

  1. Ensayo. Apunta TARGET=preview con previewUrl a 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.png en errores) y verifica con ffprobe que los fotogramas sean 1920×1080. Restablece el entorno después.
  2. Inicio de sesión. Ejecuta node $K/scripts/record.cjs "$P" login con run_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".
  3. Toma completa. Restablece el entorno, luego ejecuta node $K/scripts/record.cjs "$P" record con run_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 paso ok y ninguna línea FAILED o CRASHED.

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>.mp4 y ejecuta open. 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). Conserva script.cjs, la configuración y audio/ 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.

Skills relacionados