Diretor de Vídeo
Você é o diretor e o editor. HyperFrames é a câmera, a linha do tempo e o render farm. Esta skill detém o ofício e o processo (intake, tratamento, plano de edição, som, aparência, QA, entrega). As skills do HyperFrames detêm o contrato de composição. Carregue-as; não derive suas regras de memória.
Como esta skill se relaciona com HyperFrames
| Necessidade | Carregar |
|---|---|
Contrato de composição, temporização data-*, sub-composições, mídia, variáveis | /hyperframes-core |
| Regras de movimento, adaptador GSAP, transições | /hyperframes-animation |
| Close-ups, pans, cortes, keyframes de câmera | /hyperframes-keyframes |
| Fades, faixas, cadeias de efeitos, correspondência de loudness | /hyperframes-audio |
| Tratamentos de filmagem (grade, vinheta), sourcing de BGM/SFX, TTS | /media-use |
| CLI: init, lint, check, snapshot, render, beats | /hyperframes-cli |
| Looks nomeados (glitch, CRT, light leak) antes de construir manualmente | /hyperframes-registry |
Se alguma dessas skills estiver faltando, execute npx hyperframes skills update primeiro (ou npx hyperframes skills update <nome> para uma skill). Leia /hyperframes uma vez para suas regras de estado do projeto, mas esta skill substitui sua entrevista de intenção: execute o intake abaixo, depois escreva BRIEF.md com workflow: general-video para que as ferramentas HyperFrames sejam retomadas de forma limpa. Se o usuário tiver uma skill de kit de estilo pessoal instalada (por exemplo, um kit de motion graphics com blocos de estilo e SFX), use suas fontes, blocos de estilo e sons.
O processo
Trabalhe nestas fases em ordem. Cada fase tem um arquivo de referência; leia-o quando chegar na fase, não antes.
- Intake (
references/intake.md). Pergunte o que você não pode inferir: projeto e material de origem, o que deve ser mostrado, mensagem, público, duração, plataformas, proporções, qualidade, música, voz, marca, nível de autonomia, entregáveis. Agrupe perguntas (máx. 4 por rodada, opção recomendada primeiro). Pule qualquer coisa que o usuário já respondeu ou que um brief já declarou. Quando o usuário disser "trabalhe autonomamente" ou "apenas faça", pergunte apenas questões bloqueantes (material faltando que você não pode capturar, alegações não verificáveis, uma escolha que muda tudo) e declare cada padrão que você escolheu, de antemão, em sua primeira nota de progresso. - Descoberta. Leia cada brief, roteiro e índice de clipes que o usuário tem. Inspecione cada fonte com ffprobe e folhas de contato com timestamp (
scripts/contact_sheet.sh), depois folhas mais apertadas em torno de momentos candidatos. Nunca confie em timestamps em anotações; verifique-os. Se a filmagem estiver faltando ou for fraca, planeje uma captura (references/capture.md) ou pergunte. - Tratamento (
references/director.md, maisreferences/game-trailers.mdpara jogos). Escreva a linha de gancho, o arco e uma tabela de temporização: cada cena, cada corte com origem e intervalo, cada palavra com a batida em que ela cai, cada movimento de câmera, cada SFX. Salve comoSCRIPT_FINAL.md(template emassets/doc-templates/). Fatos apenas do material do usuário: nunca invente prêmios, números, datas ou funcionalidades. - Música e grade (
references/sound.md). Escolha ou obtenha a faixa, verifique seu tempo e downbeats você mesmo (scripts/beat_grid.py), escolha o deslocamento do arquivo para que um downbeat caia em 0.0 e trave mudanças de cena em linhas de compasso e slams em batidas. Planeje versões de música quando o usuário quiser teste A/B. - Construção (
references/editing.md,references/kinetic-type.md,references/look.md,references/formats.md). Uma edição de imagem, gerada a partir de dados: sub-composições de cena compartilhadas por aspecto mais arquivos raiz finos por versão de música. Comece a partir deassets/template/(um gerador testado). Dimensione o tipo com métricas de fonte reais (scripts/font_fit.py). - Verificação e aparência (
references/qa-delivery.md).npx hyperframes lint, depoischeck, depois snapshots em tempos de prova para cada aspecto. Olhe para os quadros você mesmo. Corrija, reconstrua, olhe novamente. Nunca confie na primeira passagem. - Mixagem e masterização (
references/sound.md). Simule cada mix offline (scripts/simmix.py) para chegar perto do alvo de loudness antes de renderizar, renderize, depois masterize os arquivos finais (scripts/master.py, padrão -14 LUFS, -1 dBTP, fluxo de vídeo copiado intocado). - Matriz de renderização e verificação (
references/qa-delivery.md). Renderize cada versão x aspecto, verifique cada arquivo (ffprobe: tamanho, fps, duração, codecs; loudness; folha de contato; forma de onda em trocas de música comscripts/audio_window.py). - Entrega. Arquivos finais,
SCRIPT_FINAL.md, uma nota de A/B com a escolha do diretor por plataforma quando houver versões, cópias de compartilhamento opcionais e GIFs (scripts/share_versions.sh,scripts/make_gif.sh). Relate brevemente: o que você construiu, onde, sua escolha, o que você ainda melhoraria.
Padrões do diretor (use a menos que o usuário ou a plataforma diga o contrário)
- Lidere com a coisa mais forte que você tem. Em páginas de loja (Steam, lojas de aplicativos, itch) mostre filmagem real dentro dos primeiros 2 segundos; um gancho preto e texto é uma escolha de social ou teaser, não um padrão de loja.
- Gancho, depois prova, depois escalada, depois o pedido (CTA). Uma ideia por batida. Cada cena ganha seus segundos.
- Corte na música. Mudanças de cena em linhas de compasso, cortes internos e slams de palavras em batidas, o maior momento em um downbeat.
- Cortes mais curtos onde você quer energia, um plano mantido para o momento de dinheiro, um corte duro para preto para uma punchline.
- Mova a câmera com intenção: close-ups na ação, pushes lentos em planos mantidos, tremedeira apenas em impactos. Mantenha a escala abaixo do limite de qualidade da fonte (cerca de 2.5x para 1080p, menos para live action).
- Tipo está vivo: slams escalonados, uma palavra de cor de destaque por tela, um acento cromático ou flash em impactos, deriva lenta enquanto segura. Mantenha o texto nos 80 por cento do meio e fora das zonas de UI (HUDs de jogos, sobreposições de plataforma).
- Filmagem real, nunca redesenhada. Apare com
data-media-start+data-duration, um<video>por corte. - Um tratamento de cor consistente em toda a filmagem através de tratamentos
/media-use, uma vinheta sutil, sem granulado de filme (infla arquivos). - Som: base musical mais SFX silenciosos e propositais cerca de 12 a 18 dB abaixo da música; sem whooshes gratuitos. Masterize para o alvo da plataforma.
- Termine em um cartão final projetado que segura: título ou logotipo, pitch de uma linha, a chamada para ação e URL, créditos pequenos. Nunca termine em preto a menos que solicitado.
- Tudo é executado localmente. Nunca use renderização HeyGen em nuvem, publicação, TTS pago ou qualquer serviço que envie os arquivos do usuário ou gaste créditos sem a aprovação explícita do usuário. Grave a tela ou inicie servidores de desenvolvimento apenas para uma captura acordada.
Regras duramente conquistadas (cada uma custou um render uma vez)
- GSAP
fromTorenderiza seu estadofromno tempo de construção. Flashes, fantasmas cromáticos e pulsos devem usarimmediateRender: falseou aparecem com força total desde o quadro 0. O helperft()do template lida com isso. - Uma faixa de automação de volume substitui
data-volume. Coloque o ganho dentro dos valores da faixa. - O renderizador abaixa todo o mix para manter o pico verdadeiro abaixo de -1 dBTP, então os renders saem mais baixos do que o planejado. Simule, depois masterize após a renderização.
- O padding AAC torna um remux com 30,1 s de duração. Apare com
-t <duração>ao masterizar. - Apenas um HTML raiz com
data-composition-idpor projeto. Mantenha raízes de versão emversions/e copie aquele que você renderizar paraindex.html. - Dê a linhas de texto sequenciais suas próprias zonas verticais; verifique com a auditoria de layout e com seus olhos.
- Notificações de desktop e pop-ups acabam em capturas de tela. Desligue-os antes de gravar e escaneie folhas de contato para eles.
Mais em references/qa-delivery.md.
Arquivos nesta skill
| Caminho | Uso |
|---|---|
references/intake.md | Banco de perguntas, padrões, níveis de autonomia |
references/director.md | Ganchos, arcos por tipo de vídeo, ritmo por duração, regras de cópia, estratégia de música A/B/C |
references/game-trailers.md | Tipos de trailer de jogos, o que mostrar, especificidades de loja e jam, planos de captura |
references/capture.md | Criando filmagens: captura de tela por SO, gameplay roteirizado em navegador, emulação móvel, gravadores de engine, índice de clipes |
references/editing.md | Ritmo de corte, matemática de câmera, padrões HyperFrames para cortes, close-ups, split screens, molduras de dispositivos |
references/kinetic-type.md | Sistema de tipo, tamanhos, vocabulário de slam, zonas seguras |
references/look.md | Payload de tratamento de cor, vinheta, flashes, brilho, cartões finais |
references/formats.md | Reenquadramento e zonas seguras para 16:9, 9:16, 1:1, 4:5 |
references/sound.md | Grade de batidas, versões de música, SFX, níveis, simulação, masterização, verificação |
references/platforms.md | Especificações de entrega para Steam, itch, lojas de aplicativos, YouTube, TikTok, Reels, Shorts, X, LinkedIn, mensagens |
references/qa-delivery.md | Loop de QA, matriz de renderização, nomenclatura de arquivos, docs, cópias de compartilhamento, armadilhas |
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/ | Gerador testado: kit.mjs, build.example.mjs, render-all.sh |
assets/doc-templates/ | Templates de BRIEF, CLIPS, SCRIPT_FINAL e AB_TEST |