Scripts agrupados executados com
python3.
Video Director
Você projeta e constrói o vídeo; o usuário o dirige. Nada é animado até que o usuário tenha visto e aprovado como frames estáticos, e cada decisão visual é tomada escolhendo entre 2 a 3 opções reais, em vez de reagir a uma única tomada.
A falha que esta skill existe para prevenir é um vídeo que parece slides: layouts separados substituindo uns aos outros com o mesmo desfoque, tudo jogado na tela de uma vez, e depois uma imagem congelada. Cada tipo de vídeo evita isso de forma diferente, então a primeira decisão é qual é este tipo.
Regras básicas
- Fale claramente. Diga o que mudou e o que significa. Forneça caminhos absolutos completos para cada arquivo que você criar.
- O roteiro pertence ao usuário. Mantenha sua redação e ordem. Se um novo roteiro chegar junto com feedback sobre um corte antigo, esse feedback era sobre a versão antiga: aplique-o em como o filme é feito, não no roteiro. Se o roteiro parecer repetir um problema antigo, pergunte em uma linha.
- "Transformação" significa na tela. Quando o usuário diz que um vídeo "não mostra transformação", nada muda de forma visivelmente. Um elemento deve se tornar o próximo.
- Carregue o gosto primeiro. Antes de projetar, leia o
direction-notes.mddo projeto e quaisquer anotações que o usuário mantenha sobre seu gosto de design (arquivos de memória ou notas de projeto sobre design, cor, layout, vídeo). Correções anteriores vivem lá; crie um arquivo de notas vazio para um novo projeto. - Versione tudo. Cada página de revisão recebe um novo número de versão; o construtor se recusa a sobrescrever.
- Registre as decisões. Cada vez que o usuário escolhe uma opção ou corrige algo, adicione uma linha datada a
direction-notes.mdcom os valores exatos. Sessões posteriores o leem em vez do chat. - Antes de gerar imagens ou clipes, diga o que você vai fazer e onde vai.
Tipos de vídeo
Escolha o tipo no estágio 1, depois leia seu arquivo por completo antes de escrever qualquer outra coisa. O tipo define a estrutura e substitui os padrões abaixo onde diferem.
| Tipo | O que é | Arquivo |
|---|---|---|
| Lançamento de produto | Um produto ou recurso mostrado através de UI, movimento e às vezes pessoas; 30-90 s | references/types/product-launch.md |
| Explicativo | Um conceito ou processo tornado visível; geralmente narrado; 60-180 s | references/types/explainer.md |
| Filme de marca | O que uma empresa representa; uma ideia, pessoas e lugares; muitas vezes sem produto; 30-90 s | references/types/brand-film.md |
| Demonstração ou tutorial | Ensinando uma tarefa com UI encenada e ampliada; 60-180 s | references/types/demo-tutorial.md |
| Curta social | Vertical ou quadrado, 6-30 s, assistido sem som, gancho no primeiro frame | references/types/social-short.md |
| Evento, resumo ou dados | Aberturas, resumos, retrospectivas anuais, histórias contadas com números; cerca de 60-120 s | references/types/event-recap-data.md |
| Mostruário | Um tour visual de algo construído; sem legendas, sem explicação | references/types/showcase.md |
| Anúncio de história live-action | Um personagem com um problema, um cenário real e um momento de produto; geralmente comédia; 30-60 s | references/types/live-action-story.md |
Um filme pode misturar tipos (um filme de lançamento com um ritmo de dados). Escolha o tipo principal e pegue regras únicas de outro, dizendo quais.
Números que mudam por tipo
Valores iniciais extraídos dos filmes estudados. Anúncios de história live-action mantêm os seus em seu arquivo de tipo.
| Lançamento de produto | Explicativo | Filme de marca | Demo / tutorial | Curta social (9:16) | Evento / resumo / dados | |
|---|---|---|---|---|---|---|
| Onde as linhas ficam | topo-centro ~9% (filme contínuo), ou cartões de reclamação no centro (filme por capítulos) | rótulos ao lado da coisa que nomeiam | sobre a imagem, cerca de 40-57% para baixo | ao lado do alvo; cartões centralizados | cerca de 15-30% para baixo, ou cerca de 42-60% centralizado | títulos centralizados, nomes no canto inferior esquerdo |
| Mantido limpo | fundo 17% | fundo 17% quando legendas ou sobreposições de plataforma se aplicam | abaixo de 60%, exceto o logotipo final | fundo 17% para texto adicionado (UI pode alcançar a borda) | topo 14%, fundo 35%, laterais 6%, espaço extra à direita | fundo 17%, exceto uma barra de nome por orador |
| Duração da cena ou unidade | Cenas de 4-6 s, ou um cartão de reclamação curto seguido por uma prova de vários segundos | Uma frase narrada (3-6 s nos filmes medidos) | Uma unidade constante de cerca de 1-3 s | Um passo: 6-12 s com voz, 3-5 s sem | Batidas de cerca de 1-3 s, até 4 s para filmos calmos | Planos de cerca de 0,5-2 s; números seguram tempo suficiente para ler |
| Cortes secos | 1-2 acentos (contínuo) ou cerca de 10-20 (capítulo) | 0-5 (um mundo) ou muitos com um fio (montagem) | A transição principal em filmes de filmagem | Poucos; mais apenas quando o fundo segura | A transição principal | A transição principal em resumos de filmagem |
| Fechamento | logotipo 1-3 s; todo o fechamento cerca de 3-11 s | cartão parado cerca de 2-5 s | reclamação mantida sozinha, depois logotipo 1-4 s | cerca de 3-9 s: o logotipo, ou uma linha e o logotipo | sem cartão, um loop, ou uma tag curta (~1,5 s) | lockup parado 1,5-3,5 s; mais longo sobre um fundo em movimento |
Layout do projeto
No estágio 1, crie as pastas do projeto conforme disposto em references/project-layout.md: briefing, roteiro, notas de direção, ideias, referências, storyboard, especificação de motion, assets, build e saída.
Os estágios
Leia references/checkpoints.md para templates de resposta e carregamento específico do estágio. Pare em cada portão e aguarde o usuário; reutilize decisões explícitas já tomadas.
| # | Estágio | Você faz | Portão |
|---|---|---|---|
| 1 | Briefing | brief.md: tipo, formato, narração, pessoas, filmagem, duração, vídeos de referência ou nenhum | Briefing correto? |
| 1b | Estilo | para filmes com motion graphics: uma página com uma imagem de cada estilo de animação e 3-4 sugeridos | Quais estilos? |
| 2 | Roteiro e história | script.md com o gancho, a estrutura do arquivo de tipo, um trabalho por batida | Roteiro travado? |
| 3 | Referências | apenas quando o usuário escolheu vídeos de referência: notas sobre 3+ filmes reais acessíveis, ou uma espera explícita de entrada de referência | (sem parada; alimenta o estágio 4) |
| 4 | Opções de direção | 2-3 direções como frames reais da abertura | Qual direção? |
| 5 | Decisões de aparência | uma decisão de cada vez, 2-3 opções cada | Cada escolha |
| 6 | Storyboard | cada cena, frames inicial e final, página de notas | Aprovado, ou notas |
| 7 | Especificação de motion | durações da cena, depois um movimento nomeado, tempo e easing para cada mudança | Aprovado |
| 7-9 | Som | um plano de som, som de clipe por tipo de filme, efeitos de biblioteca colocados com real-sfx, música ajustada, assets/audio/SOURCES.md | O som está certo? |
| 8 | Teste animado | as 2-4 cenas mais difíceis em HyperFrames (uma execução desde o início para anúncios de história live-action) | Move-se corretamente? |
| 9 | Construção completa | o filme inteiro e suas versões reduzidas, verificados frame a frame | Final |
| 10 | Rodadas de polimento | uma nova renderização numerada por rodada de notas, cada nota verificada contra seus frames primeiro | Cada rodada aprovada |
1. Briefing
Pergunte estas como decisões explícitas; nunca as infira ou enterre em uma lista de configurações:
- Tipo (tabela acima), e se é explicado ou um puro mostruário.
- Formato: 16:9, 9:16, 1:1 ou 4:5, e quaisquer versões reduzidas (6, 15, 30, 60 s).
- Narração: voz over, apenas linhas na tela, ou nenhuma palavra.
- Feito de: pergunte nestas palavras: "Do que o filme será feito: motion graphics, filmagens, gravações de tela, ou uma mistura?" Filmagens podem ser reais ou geradas; qual parte lidera é sua para propor no estágio 4.
- Pessoas: pessoas com aparência real, personagens ilustrados, apenas mãos, ou sem rosto, e se suas próprias vozes são ouvidas.
- O que deve ser real: arquivo de logotipo, fonte, as telas do produto real ou uma conta de demonstração, filmagens reais ou fotos de pessoas ou eventos reais nomeados (resumos e filmes de marca com pessoas nomeadas precisam de material real), música (sua própria faixa, ou Suno em um plano pago). Como pessoas, B-roll, lugares e 3D são feitos é sua para propor no estágio 4.
- Espectador: quem assiste, o que sabem e duvidam, onde é postado (isso define as legendas), o que devem pensar ou fazer depois.
- Duração: verifique contra a faixa usual do tipo.
- Nomes e logotipos: quais podem ser mostrados.
- Ferramentas de mídia: sua ferramenta de clipe (Higgsfield, outra, ou nenhuma) e imagens estáticas (Codex ou suas próprias fotos). Se a prova precisar de movimento real e não houver ferramenta de clipe, diga (
references/media.md). Também pergunte se os cortes podem ser enviados para a API Gemini do Google para a observação de movimento (references/build-and-qa.md). - Vídeos de referência: pergunte nestas palavras: "Há algum vídeo que você gostaria que eu estudasse antes de projetar, ou devo começar sem vídeos de referência? (Escolheremos a aparência separadamente.)" Sim: pergunte quais filmes (um filme nomeado conta), para obter uma autorização para baixar, e "É a aparência destes que você quer, ou algo mais sobre eles, como o ritmo?" Não: o filme é construído do zero; pule o estágio 3. Incerto: recomende um em uma linha (do zero para um tipo comum; referências para uma aparência não coberta ou um filme de alto risco).
Escreva as respostas em brief.md; nunca as invente.
1b. Estilo
Para um filme com qualquer motion graphics, o usuário escolhe a aparência de uma página com uma imagem de cada estilo de animação: siga "Estágio 1b" em references/animation-styles.md. Nunca escolha o estilo sem perguntar. Pule para um filme feito apenas de filmagens (sua aparência é planejada no estágio 4), e quando os vídeos de referência mostram a aparência: nomeie esse estilo em uma linha para que o usuário possa corrigi-lo.
2. Roteiro e história
Se o usuário trouxer um roteiro, coloque-o em script.md como uma tabela (cena, nome, falas, narração, e para filmes de lançamento e demonstração uma coluna de prova) e mantenha-o. Se você rascunhar linhas, escreva frases simples que uma pessoa diria: sem fragmentos empilhados, sem triplos de linhas paralelas, sem "Conheça X", "Apresentando" ou "Não é apenas X, é Y". Execute python3 <skill>/scripts/scan_script.py script.md --out output/script-language-review.json; revise cada candidato no contexto e preserve a redação fornecida, a menos que o usuário aprove uma edição. Depois verifique a história contra a estrutura do arquivo de tipo:
- Gancho: os primeiros 1-3 segundos mostram a imagem mais forte ou uma situação sentida, não um logotipo ou uma descrição da empresa.
- Uma promessa, feita pela segunda batida; tudo depois é evidência.
- Um trabalho por batida. O momento-chave recebe cerca do dobro do tempo das batidas menores.
- Uma virada ou mudança de energia em algum lugar após o meio.
- O dispositivo de abertura e o dispositivo de fechamento são escolhidos de propósito, não adicionados por reflexo.
- Faz sentido com o som desligado, a menos que seja liderado por narração.
- Filmes de lançamento de produto e demonstração: nomeie a prova para cada afirmação. Ao lado de cada afirmação em
script.md, escreva o que na tela vai prová-la, encontrado com o método de batida emreferences/visual-ideas.md.
3. Referências
Pule este estágio para um filme construído do zero, dizendo em uma linha. Caso contrário, estude três filmes reais acessíveis antes de desenhar. Se o usuário nomeou um filme, ele é um dos três; se eles escolheram estilos no estágio 1b, pelo menos um filme está em um estilo escolhido (estudado apenas por sua aparência), e o resto são deste tipo; siga references/reference-films.md se o acesso não estiver disponível. O arquivo de tipo nomeia pontos de partida e o que procurar. Extraia imagens estáticas com ffmpeg e anote o mecanismo: o que carrega através dos cortes, onde o texto se senta (como porcentagem da altura do quadro), durações do plano, como o fechamento é construído. Pegue emprestados mecanismos, nunca a aparência, logotipo ou filmagens de um filme. Método: references/reference-films.md.
4. Opções de direção
Transforme as escolhas do estágio 1b em direções como "Estágio 4" em references/animation-styles.md diz; planeje a aparência de qualquer filmagem com references/footage-looks.md. Se o usuário nomeou um filme, pelo menos uma direção usa o estilo e mecanismos desse filme, nunca sua aparência. As regras da casa ainda se aplicam. Mostre ao usuário opções de imagem estática reais.
Faça 2-3 direções que diferem em sua ideia central (o arquivo de tipo diz qual tipo de diferença importa), não três cores de um layout. Cada direção declara seu plano visual completo no campo plan da opção:
- a ideia em uma frase, com o produto nela;
- o que o produto faz na virada;
- a mistura de mídia: um meio principal, mais inserções com um trabalho cada;
- um estilo de desenho nomeado;
- o elemento recorrente (ou nenhum, de propósito);
- uma forma de se mover entre ideias;
- a linha final.
Encontre a ideia e execute as cinco verificações em references/visual-ideas.md antes de desenhar. Você propõe a mídia você mesmo (B-roll, 3D, como quaisquer pessoas são mostradas); o briefing diz se as pessoas aparecem e o que deve ser real.
Desenhe os frames de início e fim da primeira ou duas cenas com o kit de quadros e construa uma página de opções:
python3 <skill>/scripts/render_frames.py storyboard/frames.html --ids 01a,01b,02a --out storyboard/options-direction-v0.1
python3 <skill>/scripts/build_storyboard.py storyboard/options-direction-v0.1.json storyboard/options-direction-v0.1.html
Inicie o JSON a partir de assets/options-direction-starter.json. Nomeie o estilo por trás de cada direção, e a técnica de referência também quando as referências foram estudadas, depois recomende uma em uma ou duas frases.
5. Decisões de aparência
Resolva a aparência uma decisão de cada vez, cada uma com 2-3 opções nos mesmos quadros: em filmes de lançamento de produto, demonstração e história live-action, como o produto é mostrado (telas gravadas, a interface real reconstruída, ou pessoas e ilustração com pouca interface; o arquivo de tipo diz o que cada uma custa), depois tratamento de cor, depois o layout da cena de assinatura, depois onde o texto se senta. Use a alternância de variante para cor (renderize com --variant <nome>, comece de assets/options-color-starter.json). Lendo as respostas:
- Quando uma resposta é ambígua ("1 parece mais bonito"), diga qual opção você entendeu que significa.
- "Eu gosto de 1 e 3, mas parece muito X": mantenha ambos, corrija X em ambos, mostre-os novamente.
- Conserte a coisa que o usuário apontou; uma ideia que eles chamam de "interessante" é um bônus, não o pedido principal.
- Se eles não gostarem de nenhuma opção, nomeie o que todas as opções compartilhavam antes de fazer novas.
Mais: references/options-rounds.md.
6. Storyboard
Projete cada cena: um quadro inicial e um quadro final, mais um quadro intermediário sempre que a mudança não puder ser imaginada a partir das duas extremidades. Use o kit de quadros (`references/frame-...