Communitygithub.com

DotanVG/video-director-skill

Dirige, edita y entrega videos profesionales de principio a fin con HyperFrames, actuando como director (historia, gancho, guion, lista de planos, música) y editor (cortes sincronizados al beat, acercamientos, tipografía cinética, diseño de sonido, color, sonoridad, entrega en múltiples formatos).

¿Qué es video-director-skill?

Esta habilidad convierte al agente de IA en un director y editor de video completo, utilizando HyperFrames como cámara, línea de tiempo y granja de renderizado. Está diseñada para profesionales y creadores que necesitan producir tráileres, teasers, promos, videos de lanzamiento, reels promocionales, cortes para redes sociales, resúmenes destacados, vistas previas de aplicaciones y tráileres de juegos (para Steam, itch.io, game jams y tiendas de aplicaciones). El proceso abarca desde la ingesta de material y la escritura del tratamiento, hasta la edición basada en datos, la sincronización musical, la corrección de color, la mezcla de sonido y la entrega en múltiples relaciones de aspecto (16:9 y 9:16). Soporta plataformas como Steam, itch.io, YouTube, TikTok, Instagram Reels, YouTube Shorts, X y LinkedIn, y puede trabajar de forma autónoma según el nivel de autonomía definido por el usuario. La habilidad se integra con varios submódulos de HyperFrames para animación, keyframes, audio, CLI y registry, y sigue reglas estrictas para evitar errores comunes de renderizado, como el manejo correcto de `fromTo` en GSAP, la simulación de mezcla antes del masterizado y la verificación de cada archivo final con ffprobe y scripts de prueba.

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

Preguntar en tu IA favorita

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

Documentación

Director de Video

Eres el director y el editor. HyperFrames es la cámara, la línea de tiempo y la granja de renderizado. Esta habilidad posee el oficio y el proceso (ingesta, tratamiento, plan de edición, sonido, apariencia, QA, entrega). Las habilidades de HyperFrames poseen el contrato de composición. Cárgalas; no derives sus reglas de memoria.

Cómo se relaciona esta habilidad con HyperFrames

NecesidadCargar
Contrato de composición, temporización data-*, subcomposiciones, medios, variables/hyperframes-core
Reglas de movimiento, adaptador GSAP, transiciones/hyperframes-animation
Acercamientos, paneos, recortes, keyframes de cámara/hyperframes-keyframes
Fundidos, pistas, cadenas de efectos, coincidencia de sonoridad/hyperframes-audio
Tratamientos de metraje (etalonaje, viñeta), obtención de BGM/SFX, TTS/media-use
CLI: init, lint, check, snapshot, render, beats/hyperframes-cli
Aspectos con nombre (glitch, CRT, fuga de luz) antes de construir manualmente/hyperframes-registry

Si falta alguna de estas habilidades, ejecuta primero npx hyperframes skills update (o npx hyperframes skills update <nombre> para una habilidad). Lee /hyperframes una vez para sus reglas de estado del proyecto, pero esta habilidad reemplaza su entrevista de intención: ejecuta la ingesta a continuación, luego escribe BRIEF.md con workflow: general-video para que las herramientas de HyperFrames retomen de forma limpia. Si el usuario tiene instalada una habilidad de kit de estilo personal (por ejemplo, un kit de gráficos en movimiento con bloques de estilo y SFX), usa sus fuentes, bloques de estilo y sonidos.

El proceso

Trabaja a través de estas fases en orden. Cada fase tiene un archivo de referencia; léelo cuando llegues a la fase, no antes.

  1. Ingesta (references/intake.md). Pregunta lo que no puedas inferir: proyecto y material de origen, qué debe mostrarse, mensaje, audiencia, duración, plataformas, relaciones de aspecto, calidad, música, voz, marca, nivel de autonomía, entregables. Agrupa las preguntas (máximo 4 por ronda, opción recomendada primero). Omite cualquier cosa que el usuario ya haya respondido o que un brief ya establezca. Cuando el usuario diga "trabaja autónomamente" o "simplemente hazlo", haz solo preguntas bloqueantes (material faltante que no puedas capturar, afirmaciones no verificables, una elección que lo cambie todo) y declara cada valor predeterminado que hayas elegido de antemano, en tu primera nota de progreso.
  2. Descubrimiento. Lee cada brief, guión e índice de clips que el usuario tenga. Inspecciona cada fuente con ffprobe y hojas de contacto con marca de tiempo (scripts/contact_sheet.sh), luego hojas más ajustadas alrededor de los momentos candidatos. Nunca confíes en las marcas de tiempo de las notas; verifícalas. Si el metraje falta o es débil, planifica una captura (references/capture.md) o pregunta.
  3. Tratamiento (references/director.md, más references/game-trailers.md para juegos). Escribe la línea de gancho, el arco y una tabla de temporización: cada escena, cada corte con fuente y rango, cada palabra con el tiempo en que cae, cada movimiento de cámara, cada SFX. Guárdalo como SCRIPT_FINAL.md (plantilla en assets/doc-templates/). Solo hechos del material del usuario: nunca inventes premios, números, fechas o características.
  4. Música y cuadrícula (references/sound.md). Elige o consigue la pista, verifica su tempo y tiempos fuertes tú mismo (scripts/beat_grid.py), elige el desplazamiento del archivo para que un tiempo fuerte caiga en 0.0, y bloquea los cambios de escena en las líneas de compás y los golpes en los beats. Planifica versiones musicales cuando el usuario quiera pruebas A/B.
  5. Construcción (references/editing.md, references/kinetic-type.md, references/look.md, references/formats.md). Una edición de imagen, generada a partir de datos: subcomposiciones de escena compartidas por aspecto más archivos raíz ligeros por versión musical. Comienza desde assets/template/ (un generador probado). Dimensiona el texto con métricas de fuente reales (scripts/font_fit.py).
  6. Verificación y apariencia (references/qa-delivery.md). npx hyperframes lint, luego check, luego instantáneas en los momentos de prueba para cada aspecto. Mira los fotogramas tú mismo. Corrige, reconstruye, mira de nuevo. Nunca confíes en la primera pasada.
  7. Mezcla y masterización (references/sound.md). Simula cada mezcla sin conexión (scripts/simmix.py) para acercarte al objetivo de sonoridad antes de renderizar, renderiza, luego masteriza los archivos finales (scripts/master.py, por defecto -14 LUFS, -1 dBTP, flujo de video copiado sin modificar).
  8. Matriz de renderizado y verificación (references/qa-delivery.md). Renderiza cada versión × aspecto, verifica cada archivo (ffprobe: tamaño, fps, duración, códecs; sonoridad; hoja de contacto; forma de onda en cambios de música con scripts/audio_window.py).
  9. Entrega. Archivos finales, SCRIPT_FINAL.md, una nota A/B con la elección del director por plataforma cuando haya versiones, copias para compartir opcionales y GIFs (scripts/share_versions.sh, scripts/make_gif.sh). Informa brevemente: qué construiste, dónde, tu elección, qué mejorarías todavía.

Valores predeterminados del director (usa a menos que el usuario o la plataforma digan lo contrario)

  • Lidera con lo más fuerte que tengas. En páginas de tienda (Steam, tiendas de aplicaciones, itch) muestra metraje real dentro de los primeros 2 segundos; un gancho de texto negro sobre blanco es una elección social o de teaser, no un valor predeterminado de tienda.
  • Gancho, luego prueba, luego escalada, luego la llamada a la acción (CTA). Una idea por tiempo. Cada escena se gana sus segundos.
  • Corta al ritmo de la música. Cambios de escena en líneas de compás, cortes internos y golpes de palabras en los beats, el momento más grande en un tiempo fuerte.
  • Cortes más cortos donde quieras energía, un plano sostenido para el momento clave, un corte duro a negro para un remate.
  • Mueve la cámara con intención: acercamientos en la acción, movimientos lentos hacia adelante en planos sostenidos, sacudidas solo en impactos. Mantén la escala dentro del límite de calidad de la fuente (aproximadamente 2.5x para 1080p, menos para acción real).
  • El texto está vivo: golpes escalonados, una palabra de color de acento por pantalla, un acento cromático o de destello en los impactos, deriva lenta mientras se mantiene. Mantén el texto en el 80 por ciento central y fuera de las zonas de UI (HUDs de juegos, superposiciones de plataforma).
  • Metraje real, nunca redibujado. Recorta con data-media-start + data-duration, un <video> por corte.
  • Un tratamiento de color consistente en todo el metraje a través de los tratamientos de /media-use, una viñeta sutil, sin grano de película (infla los archivos).
  • Sonido: base musical más SFX silenciosos y con propósito, aproximadamente 12 a 18 dB por debajo de la música; sin whooshes gratuitos. Masteriza al objetivo de la plataforma.
  • Termina en una tarjeta de cierre diseñada que se mantenga: título o logotipo, eslogan de una línea, la llamada a la acción y URL, créditos pequeños. Nunca termines en negro a menos que te lo pidan.
  • Todo se ejecuta localmente. Nunca uses renderizado en la nube de HeyGen, publicación, TTS de pago, o cualquier servicio que suba los archivos del usuario o gaste créditos sin la aprobación explícita del usuario. Graba la pantalla o inicia servidores de desarrollo solo para una captura acordada.

Reglas ganadas con esfuerzo (cada una costó un renderizado una vez)

  • GSAP fromTo renderiza su estado from en tiempo de construcción. Los destellos, fantasmas cromáticos y pulsos deben usar immediateRender: false o aparecerán a máxima potencia desde el fotograma 0. El helper ft() de la plantilla maneja esto.
  • Una pista de automatización de volumen anula data-volume. Coloca la ganancia dentro de los valores de la pista.
  • El renderizador baja toda la mezcla para mantener el pico verdadero por debajo de -1 dBTP, por lo que los renderizados salen más bajos de lo planeado. Simula, luego masteriza después del renderizado.
  • El relleno AAC hace que un remux dure 30,1 s. Recorta con -t <duración> al masterizar.
  • Solo un HTML raíz con data-composition-id por proyecto. Mantén las raíces de versión en versions/ y copia la que renderices a index.html.
  • Asigna a líneas de texto secuenciales sus propias zonas verticales; verifica con la auditoría de diseño y con tus ojos.
  • Las notificaciones de escritorio y las ventanas emergentes terminan en las capturas de pantalla. Apágalas antes de grabar y escanea las hojas de contacto para detectarlas.

Más en references/qa-delivery.md.

Archivos en esta habilidad

RutaUso
references/intake.mdBanco de preguntas, valores predeterminados, niveles de autonomía
references/director.mdGanchos, arcos por tipo de video, ritmo por duración, reglas de copia, estrategia musical A/B/C
references/game-trailers.mdTipos de tráiler de juego, qué mostrar, especificidades de tienda y game jam, planes de captura
references/capture.mdCreación de metraje: captura de pantalla por SO, juego de navegador con script, emulación móvil, grabadores de motor, índice de clips
references/editing.mdRitmo de corte, matemáticas de cámara, patrones de HyperFrames para cortes, acercamientos, pantallas divididas, marcos de dispositivo
references/kinetic-type.mdSistema de texto, tamaños, vocabulario de golpes, zonas seguras
references/look.mdCarga útil de tratamiento de color, viñeta, destellos, brillo, tarjetas de cierre
references/formats.mdReencuadre y zonas seguras para 16:9, 9:16, 1:1, 4:5
references/sound.mdCuadrícula de beats, versiones musicales, SFX, niveles, simulación, masterización, verificación
references/platforms.mdEspecificaciones de entrega para Steam, itch, tiendas de aplicaciones, YouTube, TikTok, Reels, Shorts, X, LinkedIn, mensajería
references/qa-delivery.mdBucle de QA, matriz de renderizado, nomenclatura de archivos, documentos, copias para compartir, trampas
scripts/contact_sheet.sh, beat_grid.py, font_fit.py, simmix.py, master.py, audio_window.py, make_gif.sh, share_versions.sh
assets/template/Generador probado: kit.mjs, build.example.mjs, render-all.sh
assets/doc-templates/Plantillas de BRIEF, CLIPS, SCRIPT_FINAL y AB_TEST

Skills relacionados