HyperFrames Video Director: skill de direção para vídeo feito com IA

TL;DR

• É uma skill de direção criativa para agentes de código que fazem vídeo com HyperFrames — o agente continua escrevendo e renderizando; este repositório só decide a ideia, o ritmo, a tipografia, o movimento e o som.
• A v4 traz 17 guias de direção por tipo de vídeo, de anúncio social e lançamento de produto a tipografia cinética, visualização de dados, lyric video e meme curto — sem receita compartilhada entre eles.
• O ciclo é briefing → direção → implementação → revisão do render → revisão focada, com pelo menos duas passadas de render e revisão e uma rubrica que não tem limiar numérico validado.
• Cinco scripts opcionais de diagnóstico medem ou expõem problemas: contact sheet, checagem de amador, medição de áudio, timing derivado de timestamps de palavra e as checagens técnicas oficiais do HyperFrames.

O que é e para quem

HyperFrames Video Director é uma skill de agente em inglês para o HyperFrames, a ferramenta que renderiza composições HTML em vídeo. O README é cuidadoso na divisão de trabalho: este repositório é a camada de direção, enquanto o HyperFrames e suas skills oficiais (hyperframes-core, hyperframes-animation, hyperframes-cli) seguem responsáveis por autoria, APIs de animação, validação e render.

É para quem tem um agente que já produz vídeo tecnicamente correto e continua produzindo vídeo esquecível. A skill fornece a camada de decisão — o que o vídeo é, o que muda para o espectador, qual ideia visual carrega essa mudança — e de propósito não entrega template de composição, fonte fixa, paleta predefinida nem movimento de câmera obrigatório.

O que ela faz

• Conceito antes de efeito. O agente decide o que muda para o espectador e qual ideia visual carrega a mudança antes de escolher qualquer efeito.
• 17 guias por tipo de vídeo. Anúncio, tutorial, abertura e história de dados não compartilham uma receita; cada guia descreve intenção, hipóteses de ritmo, preferências, o que evitar e opções de técnica, mas nunca um layout pronto nem uma sequência de cenas obrigatória.
• Um vocabulário de resultados visuais. A técnica é escolhida pelo significado, não pela quantidade de efeitos.
• Revisão ancorada na saída. A rubrica avalia especificidade, clareza, tipografia, ritmo, continuidade, composição, som, identidade e entrega — com a ressalva de que não existe limiar numérico validado de qualidade profissional.
• Evidência transparente. Especificações com fonte, conselho de profissional e heurística criativa são rotulados como tipos diferentes de afirmação.

Como usar

Clone o repositório e aponte o agente para o SKILL.md:

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

Para uso por arquivo, aponte o agente para hyperframes-video-director/SKILL.md; para descoberta automática, coloque a pasta no diretório de skills que seu agente suporta. O README avisa para habilitar só uma cópia por vez. Ler a orientação não exige dependência de Python.

Depois entregue o briefing e as skills de implementação. O exemplo do README pede um anúncio de lançamento de 20 segundos, 9:16, para um app de notas offline, usando a UI fornecida e recursos verificados, com o agente inventando o conceito visual, a tipografia, a paleta, o enquadramento e a linguagem de movimento — e declarando antes de construir qual é a mudança para o espectador, o sentimento do frame final, uma escolha ousada e o que vai evitar.

Comece pelo SKILL.md e pelo guia correspondente em directing/, e carregue as referências de craft só quando mudarem uma decisão.

Os diagnósticos opcionais precisam de Python 3, Pillow e 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

O amostrador de navegador é diferente: injete scripts/sample_layout.js no documento da composição carregada, não no shell do Studio, escolha tempos dentro da duração e chame collectDirectorObservations([0.1, 2, 4]). Salve o JSON e passe para amateur_check.py com --observations. Código de saída 0 significa que nenhum erro técnico foi observado dentro das checagens executadas — o README é explícito que isso não certifica gosto, segurança de flash, determinismo completo de pixel nem som inteligível.

O ciclo de revisão é o ponto

O README pede pelo menos duas passadas de render e revisão, depois revisão dos problemas de maior impacto, e avisa contra transformar revisão em loop de polimento sem fim. Ele também exige honestidade sobre o que foi revisado: se a execução foi limitada a um take ou a trabalho só de texto, o agente deve declarar a revisão omitida em vez de dizer que ela aconteceu, e não deve tratar contact sheet como reprodução contínua nem passagem técnica como aval estético.

Evidência, não promessa

A orientação registra 71 consultas de pesquisa e liga os IDs de fonte ao nível de acesso e de confiança. Os diagnósticos passaram por checagens limitadas de fixture e de vídeo codificado, e a skill foi usada em runs informais de geração local com Qwen 27B que o README chama explicitamente de não um benchmark controlado. Nenhuma taxa de vitória, melhoria de qualidade ou garantia de diversidade é alegada.

Quando usar, quando não usar

Use quando um pipeline que já funciona continua produzindo vídeo tecnicamente bom e sem ponto de vista, e quando você quer que o agente se comprometa com uma escolha ousada e uma omissão deliberada antes de tocar na composição.

Não use como renderizador, gerador ou substituto das skills oficiais do HyperFrames — o README diz que ela complementa. E não use como certificado: código de saída aprovado é medição dentro de um escopo declarado, não afirmação de que o vídeo está bom.

O repositório tem licença MIT. Ativos externos, fontes, música e software de render mantêm os próprios termos, e a skill não libera o vídeo gerado para distribuição comercial.

Sources

1. HyperFrames Video Director — repositório — 17 guias de direção, fluxo, rubrica, diagnósticos, notas de evidência e limites citados acima.
2. README.md — quick start, briefing de exemplo, comandos dos scripts, licença e atribuição.

Página do projeto: HyperFrames Video Director

Para um pipeline de vídeo mais longo montado de ponta a ponta, veja o pipeline de produção de filme no ComfyUI.

FAQ

Este repositório renderiza vídeo? Não. O HyperFrames renderiza; a skill decide conceito, ritmo, tipografia, movimento e som. Também não é serviço de geração hospedado.

Quantos tipos de vídeo ela cobre? Dezessete guias de direção, de anúncio social e lançamento de produto a visualização de dados, lyric video, broadcast e meme curto.

Uma checagem aprovada significa que o vídeo está bom? Não. Código 0 significa nenhum erro técnico observado dentro das checagens feitas; o README diz que os scripts não certificam gosto nem inteligibilidade.

Existe limiar numérico de qualidade? Não. O README afirma que não há limiar numérico validado de qualidade profissional; a rubrica serve para julgar, não como nota para passar.