Communitygithub.com

DotanVG/video-director-skill

Dirija, edite e entregue vídeos profissionais do início ao fim com HyperFrames, atuando como diretor (história, gancho, roteiro, lista de planos, música) e editor (cortes sincronizados com a batida, close-ups, tipografia cinética, design de som, cor, loudness, entrega multi-formato).

O que é video-director-skill?

Esta skill transforma o usuário em um verdadeiro diretor e editor de vídeo, usando o HyperFrames como a câmera, a linha do tempo e o render farm. Ela é ideal para criar trailers, teasers, promos, vídeos de lançamento, montagens dinâmicas, cortes para redes sociais, reels de destaques, prévias de aplicativos e trailers de jogos (Steam, itch.io, game jams, lojas de aplicativos). A skill gerencia todo o fluxo de produção: desde a captura de novas filmagens (por gravação de tela ou gameplay roteirizado), passando pela escolha de música com versões A/B, até a entrega nos formatos 16:9 (paisagem) e 9:16 (vertical). O processo é dividido em fases claras: intake (coleta de requisitos), descoberta (análise do material), tratamento (roteiro e storyboard), música e grade, construção (edição baseada em dados), verificação e look, mixagem e masterização, renderização e entrega final. A skill também inclui referências detalhadas e scripts para garantir qualidade, como simulação de mixagem, verificação de loudness e geração de contatos visuais. Ela é compatível com Claude Code, Cursor e Codex, e depende de skills auxiliares do HyperFrames para animação, keyframes, áudio, CLI e looks pré-definidos. As regras são baseadas em experiência prática, evitando erros comuns como renders com flashes inesperados ou problemas de volume.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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

NecessidadeCarregar
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.

  1. 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.
  2. 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.
  3. Tratamento (references/director.md, mais references/game-trailers.md para 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 como SCRIPT_FINAL.md (template em assets/doc-templates/). Fatos apenas do material do usuário: nunca invente prêmios, números, datas ou funcionalidades.
  4. 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.
  5. 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 de assets/template/ (um gerador testado). Dimensione o tipo com métricas de fonte reais (scripts/font_fit.py).
  6. Verificação e aparência (references/qa-delivery.md). npx hyperframes lint, depois check, depois snapshots em tempos de prova para cada aspecto. Olhe para os quadros você mesmo. Corrija, reconstrua, olhe novamente. Nunca confie na primeira passagem.
  7. 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).
  8. 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 com scripts/audio_window.py).
  9. 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 fromTo renderiza seu estado from no tempo de construção. Flashes, fantasmas cromáticos e pulsos devem usar immediateRender: false ou aparecem com força total desde o quadro 0. O helper ft() 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-id por projeto. Mantenha raízes de versão em versions/ e copie aquele que você renderizar para index.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

CaminhoUso
references/intake.mdBanco de perguntas, padrões, níveis de autonomia
references/director.mdGanchos, 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.mdTipos de trailer de jogos, o que mostrar, especificidades de loja e jam, planos de captura
references/capture.mdCriando filmagens: captura de tela por SO, gameplay roteirizado em navegador, emulação móvel, gravadores de engine, índice de clipes
references/editing.mdRitmo de corte, matemática de câmera, padrões HyperFrames para cortes, close-ups, split screens, molduras de dispositivos
references/kinetic-type.mdSistema de tipo, tamanhos, vocabulário de slam, zonas seguras
references/look.mdPayload de tratamento de cor, vinheta, flashes, brilho, cartões finais
references/formats.mdReenquadramento e zonas seguras para 16:9, 9:16, 1:1, 4:5
references/sound.mdGrade de batidas, versões de música, SFX, níveis, simulação, masterização, verificação
references/platforms.mdEspecificações de entrega para Steam, itch, lojas de aplicativos, YouTube, TikTok, Reels, Shorts, X, LinkedIn, mensagens
references/qa-delivery.mdLoop 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

Habilidades Relacionadas