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
| Necesidad | Cargar |
|---|---|
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.
- 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. - 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. - Tratamiento (
references/director.md, másreferences/game-trailers.mdpara 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 comoSCRIPT_FINAL.md(plantilla enassets/doc-templates/). Solo hechos del material del usuario: nunca inventes premios, números, fechas o características. - 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. - 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 desdeassets/template/(un generador probado). Dimensiona el texto con métricas de fuente reales (scripts/font_fit.py). - Verificación y apariencia (
references/qa-delivery.md).npx hyperframes lint, luegocheck, 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. - 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). - 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 conscripts/audio_window.py). - 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
fromTorenderiza su estadofromen tiempo de construcción. Los destellos, fantasmas cromáticos y pulsos deben usarimmediateRender: falseo aparecerán a máxima potencia desde el fotograma 0. El helperft()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-idpor proyecto. Mantén las raíces de versión enversions/y copia la que renderices aindex.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
| Ruta | Uso |
|---|---|
references/intake.md | Banco de preguntas, valores predeterminados, niveles de autonomía |
references/director.md | Ganchos, arcos por tipo de video, ritmo por duración, reglas de copia, estrategia musical A/B/C |
references/game-trailers.md | Tipos de tráiler de juego, qué mostrar, especificidades de tienda y game jam, planes de captura |
references/capture.md | Creació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.md | Ritmo de corte, matemáticas de cámara, patrones de HyperFrames para cortes, acercamientos, pantallas divididas, marcos de dispositivo |
references/kinetic-type.md | Sistema de texto, tamaños, vocabulario de golpes, zonas seguras |
references/look.md | Carga útil de tratamiento de color, viñeta, destellos, brillo, tarjetas de cierre |
references/formats.md | Reencuadre y zonas seguras para 16:9, 9:16, 1:1, 4:5 |
references/sound.md | Cuadrícula de beats, versiones musicales, SFX, niveles, simulación, masterización, verificación |
references/platforms.md | Especificaciones de entrega para Steam, itch, tiendas de aplicaciones, YouTube, TikTok, Reels, Shorts, X, LinkedIn, mensajería |
references/qa-delivery.md | Bucle 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 |