Communitygithub.com

video-demo

Planifica y crea videos breves centrados en evidencia sobre trabajo de software: videos de cambios completados, demos de sprint, resúmenes 'Anteriormente', resultados de investigación, lanzamientos, videos conceptuales, tutoriales y reproducción de errores. Un modelo: resumen, tabla de afirmaciones, guion gráfico, ritmo, marca y revisión, para cualquier renderizador de HTML a video. Útil para 'crear un video de cambio completado', 'video de demo de sprint', 'anteriormente', 'video de resumen', 'video de investigación', 'video de lanzamiento', 'video de reproducción de error'. No para aserciones en CI. La publicación requiere autorización explícita.

¿Qué es video-demo?

Esta habilidad proporciona un modelo sistemático para crear videos breves y centrados en evidencia sobre trabajo de software. A diferencia de herramientas tradicionales de grabación de pantalla, este método prioriza mostrar hechos reales y etiquetados (como construcciones locales, datos de staging o resultados de producción) antes que el pulido artístico. El enfoque está diseñado para una variedad de formatos de video, incluyendo videos de cambios completados para revisiones de código, demos de sprint para partes interesadas, resúmenes de proyectos en curso, resultados de investigación, lanzamientos de productos, tutoriales y reproducciones de errores, cada uno con su propia plantilla de duración y estructura. El flujo de trabajo guía al usuario a través de siete pasos: crear un resumen breve y una tabla de afirmaciones, escribir un guion gráfico, capturar metraje (usando scripts de navegador automatizados o capturas de pantalla), componer las escenas, revisar visualmente antes del renderizado final, renderizar y mezclar audio, y entregar el producto final con documentación de revisión. Las reglas no negociables incluyen etiquetar siempre la clase de evidencia en pantalla, mostrar los resultados primero dentro de 1.5 segundos, garantizar la legibilidad en teléfonos (texto principal ≥80px a 1080p), usar solo activos de marca aprobados y verificar que el sonido tenga licencia. La habilidad es independiente del renderizador: cualquier herramienta que produzca fotogramas de manera determinista (como HyperFrames, Remotion o Motion Canvas) puede usarse, y las capturas guiadas por Playwright y la codificación con FFmpeg son el flujo de trabajo recomendado.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jernejk/jkstack/tree/HEAD/blueprints/demo-video

Preguntar en tu IA favorita

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

Documentación

Video demo

Un video aquí es primero evidencia y luego película. Cada fotograma muestra algo real, etiquetado por lo que es, legible en un teléfono y temporizado para que el resultado se vea antes del detalle.

Esto es un modelo, no una habilidad instalada. Describe un método que ha producido películas reales, pero no incluye ningún renderizador, grabador o verificador. Usa las herramientas que tengas; extensiones describe las que vale la pena construir. Resuelve las rutas de referencia relativas a esta carpeta de habilidad.

1. Elige el modo, luego escribe el resumen

ModoUsoDuraciónEstructura
completadoun cambio fusionado o corrección de error15–30 starjeta de introducción → el cambio en la UI real → tarjeta final con el issue o PR
sprint-demouna revisión de sprint para partes interesadas2–4 minobjetivo del sprint → 3–5 puntos completados, los más valiosos primero → no completado → siguiente
anteriormenteun episodio de un proyecto en curso1–3 minúltimo hilo abierto → partes: pregunta → resultado → qué cambió → siguiente hilo
investigaciónun experimento, spike o noche de investigación1–2.5 minpregunta → método en una imagen → resultado con su denominador → sorpresas → decisión
lanzamientoqué se envió y qué sigue1–2.5 minestructura de resumen con fusionado → lanzado → staging → estados de producción
conceptouna película conceptual, maqueta o propuesta45–95 sgancho de resultado → un ejemplo práctico → prueba → límite honesto → recompensa
tutorialcómo hacer una tarea30–90 sresultado final → pasos en la UI real → resultado final de nuevo
reproun informe de error10–30 sentorno → pasos → el fallo, retenido → resultado esperado en texto

Detalle por modo: modos. Retrospectivas, aniversarios y despedidas son la extensión de viaje en extensiones.

Antes de cualquier captura, escribe BRIEF.md en la carpeta de la película: modo, audiencia, la única conclusión, ancho de visualización (por defecto: un teléfono, 844 px en horizontal y 390 px en vertical para el reproductor), perfil de marca, la clase de evidencia de cada escena, fecha límite y resultados. Pregunta solo por lo que no puedas inferir de la solicitud o las fuentes.

2. No negociables

  • Evidencia antes que arte. Muestra UI real, resultados guardados reales y páginas fuente reales. Nunca pintes un estado que no ocurrió, inventes un número, o impliques velocidad, lanzamiento o uso en producción. Cada hecho en pantalla tiene una fila en la tabla de afirmaciones antes de que se construya su escena (evidencia).
  • Etiqueta lo que es, en pantalla, todo el tiempo. Una barra fuera de la cámara indica la clase de evidencia: Construcción local, Demo de concepto · datos de muestra, Respuesta grabada · repetida, Staging, Producción. Los conceptos y maquetas nunca se hacen pasar por funciones enviadas.
  • Resultado primero. La conclusión y un número destacado o resultado visible aparecen en aproximadamente 1.5 s del inicio de una escena y permanecen hasta el corte. Duración de la escena ≥ 1 s + palabras ÷ 3 + 1.5 s de espera (ritmo).
  • Legible en un teléfono. Texto principal ≥ 80 px a 1080p; cualquier cosa que el espectador deba leer ≥ 36 px. Demasiadas palabras: recorta palabras o recompón, nunca reduzcas.
  • UI nítida. Captura evidencia a 2× de densidad y muéstrala a ≥ 1.0 de escala o amplía. Nunca sobredimensiones una pantalla densa de 1080p y la llames primer plano.
  • Solo marca aprobada. La marca personal o de empresa proviene de un perfil de marca y los activos aprobados de esa marca (marca). Nunca redibujes, recoloques o aproximes un logotipo.
  • Sonido con licencia. La música y los efectos necesitan una licencia verificada y el crédito que requiere.
  • Completado significa verificado. Informa las comprobaciones técnicas, fotogramas inspeccionados, reproducción a velocidad y escucha por separado. La aceptación del solicitante es su propio estado (revisión).

3. Ciclo de trabajo

  1. Resumen y afirmaciones. BRIEF.md y la tabla de afirmaciones. Para películas con números, haz que un revisor independiente, idealmente de una familia de modelos diferente o una persona, verifique el texto final en pantalla, incluido el texto dentro de capturas de pantalla, antes del renderizado completo.
  2. Guion gráfico en palabras. Una línea por escena: ventana de tiempo, línea principal, imagen, etiqueta de evidencia, señal de sonido, cómo transiciona. Elige los 3–5 tipos de transición que usa la película y qué causa cada uno.
  3. Captura (captura). Flujos de navegador scriptados para metraje interactivo, captura de fotogramas con reloj falso para la animación de una página, capturas de pantalla de elementos a 2× para imágenes fijas.
  4. Composición (compositor). Los modos cortos se adaptan a un compositor guiado por especificaciones; los modos más largos se adaptan a una composición hecha a mano en una línea de tiempo pausada con escenas en una cuadrícula de barras.
  5. Inspección antes del renderizado. Captura el primer momento legible de cada escena, el punto medio, la espera final y ambos lados de cada corte. Corrige colisiones, texto recortado, fotogramas vacíos y cualquier cosa que un desconocido no pueda leer.
  6. Renderiza, mezcla, verifica. Renderiza, codifica, mezcla música y efectos, ejecuta las comprobaciones técnicas, luego lee la hoja de contactos, las tiras de corte y las hojas de teléfono tú mismo (movimiento y sonido).
  7. Entrega. Copias en silencio, con música y web, más un póster, el crédito de música junto al reproductor, y un REVIEW.md: qué se midió, qué solo se observó y la toma más débil.

4. Cadena de herramientas

Cualquier renderizador que produzca fotogramas de manera determinista servirá. HyperFrames (Apache-2.0) y un script de captura de fotogramas canalizado a FFmpeg renderizan composiciones HTML directamente. Remotion (React; revisa primero los términos de licencia de la empresa) y Motion Canvas (escenas en TypeScript) tienen sus propios modelos de escena; el contrato de composición en compositor se traduce a ellos. La automatización del navegador como Playwright impulsa la captura. FFmpeg codifica, mezcla y mide. Fija las versiones del renderizador y desactiva la telemetría donde se ofrezca.

5. Autoridad

Hacer una película autoriza la captura local, la composición y la verificación. No autoriza subidas, mensajes, comentarios en PR o issues, cambios en el producto o publicación. Usa datos de muestra o ficticios aprobados; nunca muestres nombres de clientes, clientes o personal sin aprobación, y nunca hagas zoom en una identidad con sesión iniciada.

Referencias

NecesidadLee
Perfiles de modo y estructuras narrativasmodos
Afirmaciones, etiquetas, estados, verificación de hechosevidencia
Tiempo de lectura, tamaños de texto, anchos de teléfonoritmo y teléfono
Movimiento, transiciones, música y efectosmovimiento y sonido
Perfiles de marca personal y de empresamarca
Técnicas y trampas de capturacaptura
Especificación de video completado y contrato de composicióncompositor
Etapas de revisión y sugerencias de entregarevisión y entrega
Grabador, verificadores, resúmenes desde una línea de tiempo, películas de viajeextensiones

Skills relacionados