CommunityEscrita e Ediçãogithub.com

Roteiro de Vídeo

Escreve um roteiro de vídeo a partir de um briefing em um de três modos: animação (motion graphics), live action (filmável, consciente de orçamento) ou documentário (beats narrativos, guia de entrevista, lista de B-roll). Gera um .xlsx formatado com uma aba PRÓXIMOS PASSOS contendo resumo, notas de tratamento, prompts de imagem IA, uma primeira análise legal e notas de viabilidade.

O que é Roteiro de Vídeo?

Esta skill é especializada em transformar briefings, decks, notas de produto ou ideias em roteiros de vídeo profissionais, operando em três modos distintos: animação/motion graphics, live action (comerciais, roteirizados) ou documentário (testemunhais, entrevistas, histórias de marca com pessoas reais). A skill primeiro orienta o usuário a escolher o modo apropriado e, em seguida, realiza uma coleta estruturada de informações, como nome da marca, duração, público-alvo, perfil da marca e perguntas específicas do modo. O processo de escrita segue uma estrutura narrativa clara (gancho, problema, virada, prova, produto, payoff, fechamento) e respeita regras compartilhadas para todos os modos, como textos de locução naturais e visuais descritivos. Além do roteiro propriamente dito, a skill gera uma aba 'Próximos Passos' que inclui um resumo, notas de tratamento, prompts para storyboards, uma primeira análise legal (identificando riscos em alegações, comparativos, depoimentos e categorias reguladas) e notas de viabilidade para produções live action. O resultado é um arquivo .xlsx formatado, construído via script Python, que serve como produto final e ponto de partida para as etapas seguintes, como a criação de um deck de pré-produção ou um cronograma de entrevistas. A skill também possui uma etapa de revisão obrigatória, onde o conteúdo é verificado duas vezes contra um checklist rigoroso antes de ser apresentado ao usuário, garantindo qualidade e conformidade com as regras estabelecidas.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/thinkalim/ai-video-preproduction-skills/tree/HEAD/skills/video-script

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

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

Documentação

O que Roteiro de Vídeo faz?

O roteiro é o produto. PRÓXIMOS PASSOS é um bônus que aponta para o próximo trabalho.

1. Escolha o modo primeiro

Pergunte: animação, live action ou documentário? Se o briefing tornar óbvio, diga qual você escolheu e por quê em uma linha. Em seguida, leia o guia correspondente antes de escrever:

  • Animação ou motion graphics: references/animation.md
  • Live action, comercial, roteirizado: references/live-action.md
  • Documentário, testemunhal, baseado em entrevistas, história de marca com pessoas reais: references/documentary.md

Um híbrido (live action com gráficos animados, um documentário com abertura roteirizada) usa o guia do modo principal e empresta regras do outro para aqueles quadros. Diga isso.

2. Coleta (uma mensagem curta, apenas o que está faltando)

  • Nome da marca e do produto, exatamente como o cliente diz.
  • Duração (15, 30, 60, 90s, ou mais).
  • Público-alvo e a única coisa que devem fazer ou sentir.
  • Perfil da marca. Aceite um PDF de guia de marca, logotipos, capturas de tela, um site ou notas digitadas. Extraia paleta, tipografia, regras de logotipo, tom, slogan, palavras obrigatórias e proibidas. Resuma em 5 a 8 linhas e confirme. Ofereça salvar como references/brands/<marca>.md a partir de _template.md. Nunca redesenhe um logotipo.
  • Perguntas específicas do modo do guia (dias de gravação e orçamento para live action; temas e B-roll para documentário).
  • Notas legais que o cliente já possui. Não espere por elas. A Etapa 5 faz uma primeira análise.

Trabalhe com informações parciais. Sinalize lacunas. Nunca as preencha com invenção.

3. Estrutura

Construa o arco antes de escrever as linhas: gancho, problema, virada, prova, produto, payoff, fechamento. Espaços curtos comprimem isso. Use quaisquer nomes de seção do briefing como espinha dorsal.

4. Escreva

Siga o guia do modo. Regras compartilhadas para todos os modos:

  • LOCUÇÃO é o texto final, escrito para ser falado: frases naturais e completas que carregam um pensamento real e conectam um quadro ao outro. Sem sequências de fragmentos, sem slogans empilhados. Um fragmento no fechamento, se merecer.
  • VISUAL é escrito como direção: duas a três frases completas sobre enquadramento, movimento, luz e transição, em linguagem de produção ou animação conforme o modo exigir.
  • Cerca de 2 palavras de LOCUÇÃO por segundo. Introdução e fechamento permanecem leves. Aperte primeiro os quadros mais densos.
  • Nunca invente estatísticas, citações, nomes ou alegações. Use a fonte como escrita.
  • TÍTULOS: 2 a 6 palavras. Ecoe o ritmo, nunca repita a LOCUÇÃO palavra por palavra. Linhas legais marcadas como LEGAL:.
  • Sem travessões. Sem enchimentos. Sem jargão de IA ("desbloquear", "perfeito", "no mundo de hoje").

5. Primeira análise legal

Uma lista de sinalizações, não um aconselhamento jurídico. Diga isso uma vez. Verifique cada quadro para:

  • Alegações: números, superlativos ("melhor", "#1", "comprovado"). Cada um precisa de fonte, data e escopo.
  • Comparações com concorrentes, nomeados ou implícitos.
  • Depoimentos e citações: aprovação por escrito, resultados típicos, divulgação paga.
  • Categorias reguladas: saúde, suplementos, finanças, seguros, crianças, álcool, alegações ambientais.
  • Preços, ofertas, testes: termos na tela.
  • Marcas registradas, marcas de terceiros e UIs. Direitos: música, banco de imagens, semelhança, fontes.
  • Autorizações para pessoas e locais (live action e documentário).
  • Acessibilidade: sobreposições mantidas por tempo suficiente para leitura, legendas planejadas.

Cada sinalização: quadro, palavras exatas, o risco em uma linha, uma reescrita mais segura. Nunca altere o texto aprovado silenciosamente.

6. Próximos passos (bônus, mantenha conciso)

  • Resumo: uma frase.
  • Notas de tratamento: um parágrafo curto de 3 a 5 frases sobre visual, ritmo, música e tom da locução, transições.
  • Âncora de estilo + prompts de quadro: uma linha de estilo, depois um prompt de imagem IA por quadro, para storyboards. Sem texto nas imagens, exceto no quadro do logotipo. Sem pessoas reais ou personagens registrados.
  • Viabilidade (live action): dias, locais, principais, sinalizações.
  • Sinalizações legais e perguntas em aberto.
  • Próxima skill: live action vai para um deck de pré-produção; documentário vai para um cronograma de entrevistas e lista de takes de B-roll.

7. Renderizar

python scripts/build_script.py frames.json outputs/<nome>.xlsx \
    --title "<Marca> - <Projeto>" --runtime "60-seconds" --type "Live Action" --notes notes.json

--type: Animation, Live Action ou Documentary. Cada quadro: frame, time, visual, audio, title, prompt. Para documentário, audio contém o TESTEMUNHO FONTE e TESTEMUNHO ALVO, title o terço inferior ou sobreposição. notes.json: summary, treatment, style_anchor, feasibility, legal_flags, open_questions (listas), além de para documentário interviews ([{"subject": "", "questions": [""]}]) e broll ([{"location": "", "shots": [""], "must": true}]). Exemplos: references/frames_example.json, references/notes_example.json, references/documentary_example.json.

Nome do arquivo: código do projeto, se fornecido, senão <Marca>_<Projeto>_Script_v1.xlsx.

Mantenha uma cópia do roteiro como um arquivo JSON (title, runtime, type, frames, notes). O construtor lê diretamente dele, e a próxima etapa (deck de pré-produção) captura o título dele.

Passo de revisão (sempre, antes de apresentar)

Cada resposta é executada duas vezes. O usuário nunca vê o primeiro rascunho.

  1. Rascunhe a resposta completa.
  2. Revise como um diretor criativo e produtor exigentes fariam, contra a lista de verificação abaixo e todas as regras desta skill. Leia o texto como se estivesse ouvindo em uma reunião com o cliente. Marque cada falha.
  3. Corrija cada falha, depois apresente apenas a versão revisada.
  4. Termine com uma linha: Revisão: <o que mudou>, ou Revisão: nenhuma alteração necessária.

Isso se aplica a cada etapa que produz algo: pesquisa, opções, texto, especificações e arquivos. Para um arquivo, construa-o, abra ou renderize, verifique, depois corrija e reconstrua antes de entregá-lo.

Lista de verificação

  • Os timecodes são executados sem lacunas e terminam na duração. A LOCUÇÃO está dentro do orçamento. Avisos do construtor em zero.
  • A LOCUÇÃO soa natural em voz alta como pensamentos completos que conectam um quadro ao outro, não slogans empilhados.
  • Cada VISUAL diz ao diretor, diretor de fotografia ou animador o que fazer: enquadramento, movimento, luz, transição.
  • Nenhuma estatística, citação, nome ou alegação inventada. Análise legal concluída. Sem travessões, sem jargão de IA.

8. Verifique, depois apresente

  • O construtor verifica timecodes (sem lacunas, terminando na duração) e imprime a contagem de LOCUÇÃO contra um orçamento de 2 palavras por segundo. Corrija cada aviso.
  • Nenhum número, nome ou citação inventado. Sem travessões. Análise legal concluída.
  • Apresente o arquivo. Depois 2 a 4 linhas: modo, arco, contagem de quadros, palavras de LOCUÇÃO, principais sinalizações.
  • Não faça nada extra a menos que solicitado.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Habilidades Relacionadas