Communitygithub.com

visalnaqvi/video-generator-skill

Orquesta todo el pipeline de video de un estudio, desde un brief o idea hasta el MP4 final, pasando por brand kit, escritura, storyboard, voz y renderizado, con aprobaciones en cada puerta y reanudación de videos en cualquier punto.

¿Qué es video-generator-skill?

Este skill es el director de orquesta de un estudio de producción de videos, automatizando el flujo completo desde un brief o idea hasta el video final en MP4. Su función principal es orquestar las etapas del pipeline — brand kit (solo para nuevos clientes), escritura (hook, historia, guión), storyboard (conceptos, frames de estilo, tomas y un PDF), voz en off y renderizado (música, sonido, subtítulos, video final y control de calidad) — deteniéndose en cada puerta para obtener la aprobación del usuario antes de continuar. Es útil para cualquier desarrollador o usuario que quiera crear un video de principio a fin (por ejemplo, 'haz un video promocional para…'), continuar un video existente desde donde se quedó ('continúa el video de Stargate'), o consultar el estado de todos los videos. Este skill no realiza el trabajo de las etapas por sí mismo, sino que invoca otros skills especializados (write, storyboard, voiceover, render) según sea necesario, siguiendo las reglas del estudio: priorizar lo gratuito, mantener un sonido contenido, preservar tokens sin perder calidad, y mantener al usuario informado con resúmenes cortos después de cada etapa.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/visalnaqvi/video-generator-skill/tree/HEAD/.claude/skills/produce

Preguntar en tu IA favorita

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

Documentación

Producir — De brief a video final

El director de orquesta del estudio. Cada etapa es su propio skill y realiza su propio trabajo; este skill decide qué etapa ejecutar a continuación, asegura que cada puerta se apruebe antes de avanzar y mantiene al usuario orientado. Las etapas se entregan a través de archivos en videos/<video>/, nunca llamando directamente a los scripts de otras etapas.

brand-kit (nuevos clientes) → escribir → storyboard → voz en off → renderizar

Dónde estamos

node studio/scripts/status.mjs videos/<video> — lee los archivos del video e imprime cada etapa (completado / esperando aprobación / desactualizado / no iniciado), la próxima acción y escribe videos/<video>/status.md. Sin argumento, lista todos los videos y su siguiente paso. Ejecútalo al inicio de cada sesión de producción y después de cada etapa.

Iniciar un nuevo video

  1. Obtén la solicitud: cliente/marca (¿sitio web?), para qué es y cualquier detalle del brief que el usuario ya haya dado. No interrogues — el skill de escritura recoge el brief.
  2. Marca: si el cliente no tiene un kit aprobado en studio/brands/, ejecuta el skill brand-kit (incluye la biblioteca de activos). Kit aprobado existente → reutilizarlo. Universo: solo si el usuario nombra un universo o uno de sus personajes (ej. "con Nox", "en el Noxverse"), el video usa ese universo (skill universo): su paleta reemplaza el brand kit a menos que el usuario pida explícitamente también una marca de cliente. Nunca sugieras ni preguntes sobre universos de otra manera — se sigue el flujo normal.
  3. Ejecuta el skill escribir. Crea videos/<AAAA-MM-DD>-<slug>/ y el brief, luego hook → historia → guión con aprobaciones.

Continuar un video

Ejecuta status.mjs, luego invoca el skill para la siguiente acción:

Próxima acción desde statusSkill
brand kit faltante / sin aprobar / sin biblioteca de activosbrand-kit
universo nombrado en el brief pero faltanteuniverso
brief, hook, historia o guión sin aprobarescribir
storyboard no iniciado, esperando aprobación o desactualizadostoryboard
voz en off no iniciada, no ajustada, esperando aprobación o desactualizadavoz-en-off
video final no renderizado, esperando aprobación o desactualizadorenderizar
completadodile al usuario que el video es final; ofrece variaciones o un nuevo video

Invoca los skills de etapa con la herramienta Skill y sigue sus instrucciones al completo — incluyendo sus propios pasos de aprobación. No acortes el proceso de una etapa desde aquí.

Puertas (siempre detenerse para el usuario)

  1. Brand kit (nuevos clientes) · 2. Hook · 3. Historia · 4. Guión · 5. Concepto · 6. Frames de estilo ·
  2. Storyboard + PDF · 8. Voz (audición + previsualización) · 9. Video final.

Videos de universo: el storyboard se muestra para aprobación (puerta 7) solo cuando studio/scripts/board-check.mjs pase — status.mjs muestra check ✓ / check ✗ en la línea del storyboard y señala el check mientras falla.

La aprobación debe venir del usuario en el chat para este video y puerta. "Me gusta", "aprobado", "adelante" cuentan; el silencio o una pregunta no. Una aprobación nunca cubre la siguiente puerta. Después de cada puerta, da un estado de una línea y el siguiente paso.

Cambios después de la aprobación

  • Nombra la etapa dueña del cambio: palabras → escribir; aspecto, animación, transiciones, pistas de sonido → storyboard; voz, ritmo, sincronización → voz en off; música, subtítulos, mezcla, exportación → renderizar.
  • El skill dueño incrementa version; las etapas siguientes se vuelven desactualizadas (el estado muestra ⚠️). Re-ejecuta solo lo desactualizado, en orden. Nunca dejes archivos desactualizados atrás — elimina salidas que ya no coincidan (ej. una vista previa antigua) una vez que estén reemplazadas.

Reglas del estudio (aplican en cada etapa)

  • Gratuito primero. Herramientas de pago (voz ElevenLabs, imágenes IA, música IA) solo cuando el usuario lo solicite o apruebe un presupuesto en el chat.
  • Sonido contenido. Solo momentos clave; sin "whoosh" en cada transición.
  • Las palabras vienen del guión. Solo el skill de escritura cambia palabras.
  • Ahorra tokens sin perder calidad: los guiones miden y reportan JSON; mira hojas de contactos, no frames individuales; no veas MP4s — envíalos al usuario.
  • Mantén al usuario orientado: después de cada etapa, un breve resumen + qué sigue.

Reporte

Cuando te pregunten "¿dónde estamos?" o al final de una sesión: ejecuta status.mjs (todos los videos o uno) y resume en una tabla corta: video · etapa · siguiente paso · algo que espera del usuario.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

Skills relacionados