HyperFrames Video Director: skill de dirección para vídeo hecho con IA

TL;DR

• Es una skill de dirección creativa para agentes de código que hacen vídeo con HyperFrames — el agente sigue escribiendo y renderizando; este repositorio solo decide la idea, el ritmo, la tipografía, el movimiento y el sonido.
• La v4 trae 17 guías de dirección por tipo de vídeo, de anuncio social y lanzamiento de producto a tipografía cinética, visualización de datos, lyric video y meme corto — sin receta compartida entre ellas.
• El ciclo es briefing → dirección → implementación → revisión del render → revisión enfocada, con al menos dos pasadas de render y revisión y una rúbrica que no tiene umbral numérico validado.
• Cinco scripts opcionales de diagnóstico miden o exponen problemas: hoja de contactos, chequeo de aficionado, medición de audio, timing derivado de timestamps de palabra y las comprobaciones técnicas oficiales de HyperFrames.

Qué es y para quién

HyperFrames Video Director es una skill de agente en inglés para HyperFrames, la herramienta que renderiza composiciones HTML a vídeo. El README es cuidadoso con la división del trabajo: este repositorio es la capa de dirección, mientras HyperFrames y sus skills oficiales (hyperframes-core, hyperframes-animation, hyperframes-cli) siguen a cargo de la autoría, las APIs de animación, la validación y el render.

Es para quien tiene un agente que ya produce vídeo técnicamente correcto y sigue produciendo vídeo olvidable. La skill aporta la capa de decisión — qué es el vídeo, qué cambia para el espectador, qué idea visual lleva ese cambio — y a propósito no entrega plantilla de composición, fuente fija, paleta predefinida ni movimiento de cámara obligatorio.

Qué hace

• Concepto antes que efecto. El agente decide qué cambia para el espectador y qué idea visual lleva ese cambio antes de elegir cualquier efecto.
• 17 guías por tipo de vídeo. Anuncio, tutorial, apertura e historia de datos no comparten receta; cada guía describe intención, hipótesis de ritmo, preferencias, qué evitar y opciones de técnica, pero nunca un layout listo ni una secuencia de escenas obligatoria.
• Un vocabulario de resultados visuales. La técnica se elige por el significado, no por la cantidad de efectos.
• Revisión anclada en la salida. La rúbrica evalúa especificidad, claridad, tipografía, ritmo, continuidad, composición, sonido, identidad y entrega — con la advertencia de que no existe umbral numérico validado de calidad profesional.
• Evidencia transparente. Especificaciones con fuente, consejo de profesional y heurística creativa se etiquetan como tipos distintos de afirmación.

Cómo usarla

Clona el repositorio y apunta el agente al SKILL.md:

git clone https://github.com/artificialguybr/hyperframes-video-director.git

Para uso por archivo, apunta el agente a hyperframes-video-director/SKILL.md; para descubrimiento automático, pon la carpeta en el directorio de skills que tu agente soporta. El README avisa de habilitar solo una copia a la vez. Leer la orientación no exige dependencias de Python.

Después entrega el briefing y las skills de implementación. El ejemplo del README pide un anuncio de lanzamiento de 20 segundos, 9:16, para una app de notas offline, usando la UI aportada y funciones verificadas, con el agente inventando el concepto visual, la tipografía, la paleta, el encuadre y el lenguaje de movimiento — y declarando antes de construir cuál es el cambio para el espectador, el sentimiento del frame final, una elección audaz y qué va a evitar.

Empieza por el SKILL.md y por la guía correspondiente en directing/, y carga las referencias de craft solo cuando cambien una decisión.

Los diagnósticos opcionales necesitan Python 3, Pillow y FFmpeg:

python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install Pillow

python3 scripts/contact_sheet.py output.mp4 -o contact-sheet.png
python3 scripts/amateur_check.py output.mp4 --genre social-ad --project ./my-video
python3 scripts/measure_audio.py output.mp4 --script narration.txt
python3 scripts/derive_scene_timings.py words.json --anchors "The problem" "The result" -o timings.json
bash scripts/validate_project.sh ./my-video

El muestreador de navegador es distinto: inyecta scripts/sample_layout.js en el documento de la composición cargada, no en el shell de Studio, elige tiempos dentro de la duración y llama collectDirectorObservations([0.1, 2, 4]). Guarda el JSON y pásalo a amateur_check.py con --observations. El código de salida 0 significa que no se observó error técnico dentro de las comprobaciones ejecutadas — el README es explícito en que eso no certifica gusto, seguridad de flash, determinismo completo de píxeles ni sonido inteligible.

El ciclo de revisión es el punto

El README pide al menos dos pasadas de render y revisión, luego revisión de los problemas de mayor impacto, y avisa contra convertir la revisión en un bucle de pulido sin fin. También exige honestidad sobre lo revisado: si la ejecución se limitó a un take o a trabajo solo de texto, el agente debe declarar la revisión omitida en vez de decir que ocurrió, y no debe tratar una hoja de contactos como reproducción continua ni una pasada técnica como aval estético.

Evidencia, no promesa

La orientación registra 71 consultas de investigación y une los IDs de fuente con su nivel de acceso y confianza. Los diagnósticos pasaron por comprobaciones limitadas de fixture y de vídeo codificado, y la skill se usó en runs informales de generación local con Qwen 27B que el README llama explícitamente no un benchmark controlado. No se alega tasa de victoria, mejora de calidad ni garantía de diversidad.

Cuándo usarla, cuándo no

Úsala cuando un pipeline que ya funciona siga produciendo vídeo técnicamente bueno y sin punto de vista, y cuando quieras que el agente se comprometa con una elección audaz y una omisión deliberada antes de tocar la composición.

No la uses como renderizador, generador ni sustituto de las skills oficiales de HyperFrames — el README dice que las complementa. Y no la uses como certificado: un código de salida aprobado es una medición dentro de un alcance declarado, no la afirmación de que el vídeo es bueno.

El repositorio tiene licencia MIT. Los activos externos, fuentes, música y software de render mantienen sus propios términos, y la skill no libera el vídeo generado para distribución comercial.

Sources

1. HyperFrames Video Director — repositorio — 17 guías de dirección, flujo, rúbrica, diagnósticos, notas de evidencia y límites citados arriba.
2. README.md — quick start, briefing de ejemplo, comandos de los scripts, licencia y atribución.

Página del proyecto: HyperFrames Video Director

Para un pipeline de vídeo más largo montado de punta a punta, mira el pipeline de producción de cine en ComfyUI.

FAQ

¿Este repositorio renderiza vídeo? No. HyperFrames renderiza; la skill decide concepto, ritmo, tipografía, movimiento y sonido. Tampoco es un servicio de generación alojado.

¿Cuántos tipos de vídeo cubre? Diecisiete guías de dirección, de anuncio social y lanzamiento de producto a visualización de datos, lyric video, broadcast y meme corto.

¿Una comprobación aprobada significa que el vídeo es bueno? No. El código 0 significa que no se observó error técnico dentro de las comprobaciones hechas; el README dice que los scripts no certifican gusto ni inteligibilidad.

¿Existe umbral numérico de calidad? No. El README afirma que no hay umbral numérico validado de calidad profesional; la rúbrica sirve para juzgar, no como nota para aprobar.