Communitygithub.com

screen-demo

Crea un video demo pulido (y un GIF) de cualquier sitio web o aplicación web, mediante código. Claude examina la página, planifica un recorrido y un script lo reproduce en Chromium con un cursor suave, clics reales, escritura y desplazamientos con easing, luego renderiza un video de 1920x1080 (o vertical, o cuadrado) con zooms en lo importante, anillos de resaltado, leyendas y una tarjeta de título.

¿Qué es screen-demo?

Screen-demo es una habilidad para agentes de IA (como Claude Code, Cursor, Codex) que convierte cualquier URL en un video demo profesional y/o GIF. El agente actúa como director: inspecciona la página web, escribe un recorrido en JSON, y un script automatizado reproduce ese recorrido en Chromium, capturando fotograma a fotograma (30 fps) desplazamientos, movimientos del cursor y escritura para lograr una animación suave. Luego, edita el video agregando zooms, anillos de resaltado, leyendas y una tarjeta de título, y genera un archivo MP4 (y opcionalmente GIF) listo para usar en READMEs, YouTube, Shorts o presentaciones. Es compatible con formatos landscape (16:9), vertical (9:16) y cuadrado, y se configura fácilmente con Python, Playwright y ffmpeg. La habilidad incluye reglas estrictas de seguridad: nunca solicita contraseñas, números de tarjeta ni realiza acciones destructivas, y rechaza banners de cookies a menos que el usuario indique lo contrario.

Compatible con✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/gabrielebolognese/screen-demo/tree/HEAD/skills/screen-demo

Preguntar en tu IA favorita

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

Documentación

¿Qué hace screen-demo?

Convierte una URL en un video demo. Eres el director: examinas la página, escribes el recorrido como JSON, y el script lo reproduce, captura los fotogramas propios de la página (nunca el escritorio) y edita el video. Los desplazamientos, el deslizamiento del cursor y la escritura se capturan fotograma a fotograma a 30 fps, por lo que son suaves incluso en una página pesada; lo que la página hace por sí misma después de un clic o una carga proviene de la screencast en vivo.

Configuración (una vez)

  1. Python 3.10+ con Pillow y un Playwright reciente: python -m pip install -U playwright pillow, luego python -m playwright install chromium.
  2. ffmpeg en PATH (winget install ffmpeg, brew install ffmpeg).

Verifica con python tests/selftest.py (una página local, sin red, aproximadamente un minuto).

Flujo de trabajo

  1. Pregunta para qué es el video: la URL, las 2 a 4 cosas que mostrar (el hero, una característica, el precio, un flujo de registro), el formato (landscape 16:9 para YouTube y READMEs, vertical 9:16 para Shorts y Reels, square), y si quieren un GIF. Solo el sitio o aplicación propios del usuario, o una página pública que tenga permiso de mostrar.
  2. Examina la página: python scripts/demo.py inspect URL WORK [--format vertical]. Lee cada WORK/page-N.jpg (la página en segmentos del tamaño de la ventana, cada elemento cliqueable enmarcado con un número rojo) y WORK/elements.txt. Aquí aparece un banner de cookies o una ventana emergente: el primer paso del recorrido lo cierra (el botón "Rechazar" o "Cerrar").
  3. Escribe WORK/tour.json (formato en references/tour-format.md): una tarjeta de título, luego pasos cortos. Un buen recorrido: una leyenda que dice qué hace el producto, un desplazamiento a lo primero que vale la pena ver, un zoom en ello, un clic o algo de escritura que muestre el producto funcionando, un resaltado en el resultado, una leyenda por idea. De 15 a 40 segundos. Los objetivos son los números de inspect (#12), o css=... o text=....
  4. Graba: python scripts/demo.py record WORK/tour.json OUT [--gif]. Reproduce el recorrido, imprime cada paso que falló, y renderiza OUT/demo.mp4 (y OUT/demo.gif).
  5. Revisa OUT/keys.jpg (un fotograma de cada paso) antes de darlo por terminado: un zoom en lo incorrecto, una leyenda sobre el punto del fotograma, un paso que falló (el elemento se movió o estaba oculto), un banner todavía en medio. Para cambiar solo las leyendas, zooms o la tarjeta de título, edita OUT/tour.json y ejecuta python scripts/demo.py render OUT [--gif] (sin nueva grabación); para cualquier otra cosa, graba de nuevo.
  6. Entrega: la ruta de demo.mp4 (y el GIF), su duración, y una línea por cada idea que muestra.

Reglas

  • Nunca iniciar sesión con una contraseña, nunca escribir una contraseña o número de tarjeta (el script rechaza campos de contraseña y pago), nunca comprar, enviar, publicar o eliminar nada, nunca enviar un formulario con datos personales de alguien. Una demo de un área con inicio de sesión requiere que el usuario proporcione una página de cuenta de prueba ellos mismos.
  • Rechazar banners de cookies (la menor cantidad de datos) a menos que el usuario indique lo contrario.
  • Mantener las leyendas cortas (3 a 8 palabras); una idea por leyenda; el movimiento propio del video hace el resto.
  • Respetar el sitio: ningún recorrido de una página que el usuario no tenga permiso de mostrar.

Ejemplo

Usuario: "haz un demo de 20 segundos de mi landing page https://example.com para el README, muestra el registro"

Ejecutas inspect, lees las 3 imágenes, ves un banner de cookies (#2 "Rechazar todo"), el hero, un campo "Pruébalo" (#9) y una tarjeta de precios (#21); escribes un recorrido: una tarjeta de título, clic en #2, leyenda "Notas que se escriben solas", escribir en #9, clic en #10, resaltar el resultado, leyenda "Gratis para siempre", desplazarse a #21, zoom; grabas con --gif, abres keys.jpg, ves que el zoom enmarcó bien el precio, y respondes con demo.mp4 (21 s), demo.gif (3 MB) y las cuatro ideas.

Skills relacionados