Communitygithub.com

ahnchiyoon87/claude-skills

Graba el proceso de uso real de un servicio con Playwright y añade subtítulos desde la perspectiva del consumidor para crear un video demo de menos de 5 minutos. Se usa con frases como 'graba el video', 'video demo', 'video de demostración', 'convierte el proceso en video'. No cubre diapositivas de presentación ni guías prácticas.

¿Qué es claude-skills?

Esta habilidad permite a un agente de IA generar automáticamente videos demo de alta calidad, mostrando el uso real de un servicio desde la perspectiva del usuario final, en menos de 5 minutos. Utiliza Playwright para grabar la interacción real con la interfaz de usuario, evitando simulaciones o cambios en datos de producción. El resultado incluye un archivo MP4 con subtítulos integrados (SRT) y el archivo SRT por separado, con narraciones centradas en los beneficios para el usuario, no en términos técnicos internos. Soporta plataformas como Claude Code, Cursor y Codex, y sigue un flujo estructurado de 6 pasos: dividir la solicitud en escenas, grabar con Playwright en velocidad humana, escribir subtítulos claros, editar para cumplir el límite de 5 minutos, componer con ffmpeg y verificar la calidad visual y de subtítulos. Es ideal para desarrolladores y equipos de producto que necesitan demostraciones rápidas y realistas de sus servicios sin edición manual compleja.

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

Preguntar en tu IA favorita

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

Documentación

Video demo

Un video demo muestra el proceso de uso real de un servicio desde la perspectiva del consumidor. Menos de 5 minutos. Con solo decir "graba este proceso en video y añádele una explicación sencilla", se completa el video usando los valores predeterminados que se indican a continuación.

Valores predeterminados: grabación con Playwright (1280×720) · narración en subtítulos (SRT + incrustados), solo con audio si se solicita · resultado en mp4 + srt. La forma de desplegar el servicio, las cuentas de prueba y el estilo del video siguen lo indicado en el archivo CLAUDE.md del proyecto.

Pasos

  1. Dividir en escenas — Desglosar la solicitud en un flujo que el usuario experimentaría, de 3 a 6 escenas. Para cada escena, describir "lo que se ve" y "una o dos frases de explicación".

  2. Grabar la ejecución real completa — Desplegar el servicio y usar Playwright recordVideo (del mismo tamaño que el viewport) para realizar la operación de principio a fin. A velocidad humana (slowMo alrededor de 300 ms), esperar después de cada clic hasta que el resultado sea visible en pantalla. El archivo de video se completa solo al cerrar el contexto. Regrabar solo las escenas que fallaron. Anotar los tiempos de referencia de grabación (inicio, resultado visible, fin) para cada escena.

  3. Escribir subtítulos — Sin usar jerga interna ni nombres de código, explicar "qué mejora para el usuario". Una o dos frases por escena, dichas después de que el resultado sea visible.

    • Malo: "Se genera un PR que cambia el hit policy de la regla DMN 3 a FIRST"
    • Bueno: "Las reglas duplicadas se ordenan, así que un mismo pedido ya no recibe descuentos dobles".
  4. Editar para que dure menos de 5 minutos — Recortar o acelerar las secciones de carga o espera. Mantener intactos los momentos de interacción y la lectura del resultado (2-3 segundos). Si aún excede el límite, fusionar escenas. No omitir los pasos clave mencionados en la solicitud.

  5. Componer — Unir los segmentos con ffmpeg y recalcular los SRT según los tiempos del editado final para incrustarlos. En Windows, moverse a la carpeta de trabajo y usar rutas relativas (problema de escape de : en la ruta). Fuente: en Windows, Malgun Gothic; en Linux, una fuente coreana instalada (ej. Noto Sans CJK KR).

    ffmpeg -i edited.mp4 -vf "subtitles=demo.srt:force_style='FontName=Malgun Gothic,FontSize=22'" -c:a copy demo.mp4
    
  6. Verificar — Comprobar que la duración sea ≤ 300 segundos con ffprobe -v error -show_entries format=duration -of csv=p=0 demo.mp4. Extraer fotogramas en varios tiempos de los subtítulos (ffmpeg -ss <segundos> -i demo.mp4 -frames:v 1 f_<segundos>.png) y abrirlos directamente para verificar que el texto del subtítulo coincida con lo que se muestra en pantalla y que el coreano no se vea corrupto.

Reglas a seguir

  • No usar pantallas falsas, respuestas mock, inyección de valores en el DOM ni clics forzados para crear escenas. Si no se puede completar la grabación, informar que no es posible.
  • Las operaciones difíciles de revertir, como fusionar PRs reales, modificar datos en producción, enviar mensajes o realizar pagos, solo deben hacerse en el entorno de pruebas definido por el proyecto. Si no existe ese entorno, preguntar al usuario justo antes de esa escena. Asegurarse de que contraseñas y tokens no sean visibles en la pantalla ni en los subtítulos.
  • Informe: rutas de mp4 y srt, duración real, descripción de cada escena, fotogramas verificados visualmente y elementos no verificados. Publicar o enviar solo si se solicita explícitamente.

Skills relacionados