Communitygithub.com

Video Director

Dirige y produce vídeos terminados utilizando arte IA con primeros planos SVG editables, interfaz de usuario real o 3D procedural. Útil para vídeos explicativos, demostraciones de productos, vídeos de lanzamiento, Shorts y estudios de antes/después que necesiten imágenes legibles, anotaciones temporizadas, captura suave y un MP4 de revisión local. No es para una imagen aislada ni una animación web ordinaria sin un resultado de vídeo.

¿Qué es Video Director?

Video Director es una habilidad diseñada para agentes de IA que necesitan crear vídeos completos y comprensibles, no meramente animados. Su objetivo es elegir el medio más adecuado para representar fielmente una acción importante, ya sea mediante arte generado por IA con superposiciones SVG editables, la interfaz de usuario real de un producto o gráficos 3D procedurales. La habilidad incluye un conjunto de scripts auxiliares (como capture.mjs, serve.mjs, verify.mjs) que gestionan la captura de pantalla exacta en fotogramas, el servicio local seguro, la composición de clips y la verificación de la salida codificada. Está diseñada para plataformas como Claude, Cursor o Codex, donde un agente puede interpretar una solicitud y producir un vídeo MP4 reproducible localmente, siguiendo un flujo de trabajo que separa la generación del montaje, preserva los límites de revisión y evita la publicación no autorizada. Para los desarrolladores, esto significa poder automatizar la creación de vídeos explicativos, demostraciones de productos y estudios comparativos con alta fidelidad visual, control temporal exacto y la capacidad de revisar y ajustar cada paso antes de la entrega final.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aakashH242/video-director/tree/HEAD

Preguntar en tu IA favorita

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

Documentación

¿Qué hace Video Director?

Haz que el sujeto sea comprensible, no meramente animado. Elige el medio menos complicado que muestre la acción importante de forma veraz. Esto es una habilidad con ayudantes integrados, no una aplicación separada ni una biblioteca de Python.

Resumen y receta

Establece el sujeto, la audiencia, la duración, la relación de aspecto, la acción clave y el límite de entrega a partir de la solicitud. Conserva las voces aprobadas, el material grabado y el posicionamiento actual del producto. Toma decisiones menores reversibles; pregunta sobre las decisiones importantes faltantes, los derechos o los costes. La creación no autoriza la publicación.

Muestra el resultado interesante al principio. Escribe oraciones cortas y específicas: "Mira qué página obtiene clics", no "Integra tu flujo de trabajo". Mantén la interfaz de usuario real el tiempo suficiente para que se pueda leer. Establece el mecanismo completo antes de explicar sus partes.

Lee solo la receta relevante:

  • Primera ejecución o configuración de dependencias: first-video.md, un ejemplo SVG autocontenido con un tiempo de ejecución fijo y comandos de exportación.
  • Arte generado + primer plano editable: hybrid-scenes.md.
  • Interfaz de usuario real del producto: real-ui.md.
  • Mecanismos y 3D: 3d-explainers.md.
  • Narración, pausas y música: audio.md.
  • Tiempo de ejecución, captura y verificación: production.md.
  • Comparación emparejada y plantilla ejecutable: before-after.md.
  • CLI opcional de MoneyPrinterTurbo: moneyprinterturbo.md, cuando el montaje automatizado de material/guion/audio sea adecuado.

Elige una composición/paleta nueva investigada cuando se solicite. No impongas el estilo de un canal en cada película. Los colores complementarios pueden separar los sujetos, pero las etiquetas y el contraste también deben funcionar sin pistas de color.

Decisiones de producción

  1. Mantén lo controlable bajo control. El texto, las flechas, los resaltados, el encuadre de la interfaz de usuario y la geometría factual pertenecen a SVG/HTML/canvas o 3D. Los píxeles generados son arte útil, no una interfaz de usuario exacta ni una verdad mecánica.
  2. Muestra la acción. Los clics reales necesitan un puntero visible y una entrada; las operaciones reales necesitan su estado/material real. No anime una captura de pantalla como si hubiera ocurrido una operación de backend. Nombra una parte a medida que aparece su resaltado; rastrea su ancla en movimiento.
  3. Escenifica la atención. Una acción didáctica a la vez. Suaviza los movimientos de la cámara, estabiliza y luego mantén. Deriva las posiciones del tiempo absoluto, no de los deltas de fotogramas acumulados. El movimiento secundario debe apoyar la explicación. La rotación lineal es correcta para un eje de velocidad constante.
  4. Compón para la salida. Una versión vertical necesita su propio encuadre/colocación de etiquetas legibles, no un recorte automático horizontal. Mantén las anotaciones alejadas de las partes, otras etiquetas y superposiciones de la plataforma.
  5. Separa la generación del montaje. Guarda el arte aprobado y el discurso en bruto. Registra los prompts, las fuentes, los derechos, la configuración y los hashes. Una generación con tiempo de espera agotado puede haber creado un trabajo facturado; compruébalo antes de reintentar. Resuelve el alcance/coste facturado por separado antes de gastar.
  6. Preserva los límites de revisión. Usa una nueva carpeta de salida, preserva los maestros/archivos de recuperación y rechaza las sobrescrituras accidentales. Detente antes de la subida/publicación a menos que esté autorizado por separado.

Ayudantes de trabajo

Estos adaptan la captura de tiempo explícito, el servicio local seguro, el montaje de clips y las comprobaciones de salida codificada utilizados en las producciones Pip. Resuelve <skill> desde la ubicación de este archivo. Ejecuta desde el proyecto de vídeo, no desde la carpeta de la habilidad. Lee production.md primero.

AyudantePropósito
scripts/create-example.mjsCopiar un primer proyecto autocontenido en una carpeta nueva; nunca sobrescribir.
scripts/doctor.mjsComprobar dependencias y lanzar Chromium; sin instalaciones automáticas.
scripts/capture.mjsPágina local → H.264 silencioso de fotograma exacto; reintentos en el mismo momento; hashes de origen/receipt de error.
scripts/serve.mjsServidor estático solo de bucle de retorno con rangos y contención de rutas.
scripts/compare.mjsComparación lado a lado etiquetada; rechazar discrepancia de duración/fps.
scripts/audio.mjsClips de voz existentes + pausas explícitas → WAV y manifiesto de temporización medido.
scripts/verify.mjsSondear/decodificar completamente/hashear, todas las estadísticas de fotogramas adyacentes y hoja de contacto codificada.
scripts/self-test.mjsPruebas de regresión para ayudantes y protección contra sobrescritura.
scripts/boundary-test.mjsRegresiones de red del navegador local y audio dañado.

Requiere Node, FFmpeg/FFprobe y Playwright/Chromium accesible desde el proyecto; Three.js solo para 3D. Los ayudantes no instalan paquetes/modelos, llaman a proveedores, leen credenciales ni publican. assets/first-video/ es solo código y no necesita medios externos. La plantilla de comparación en assets/comparison-study/ contiene código y un manifiesto de activos, no capturas de pantalla privadas, medios generados, fuentes ni Three.js con licencia.

Entrega

Haz una pasada de temporización a baja velocidad de fotogramas antes de la captura final. Comprueba la duración codificada, dimensiones, fps, decodificación completa, color, fotogramas clave legibles y límites de transición. Las métricas apoyan la inspección; una gran diferencia de fotogramas puede ser una edición intencional, mientras que las diferencias bajas pueden ocultar una animación congelada. Mira la película y escucha el discurso. ASR y WAV limpios no prueban una voz natural.

Entrega un MP4 local reproducible y la ruta de origen, con comprobaciones y omisiones. No afirmes 60 fps en tiempo real a partir de una captura fuera de línea, un resultado histórico de una línea base construida, o una prueba de agente independiente de la ejecución del propio autor.

Consulta lineage.md para inspiraciones y límites de licencia. Las habilidades instaladas especializadas pueden complementar esta; el flujo de trabajo no requiere cargar todas las habilidades ni copiar repositorios upstream.

Skills relacionados