Communitygithub.com

Construtor de Deck de Pré-Produção

Construa um deck completo de pré-produção (.pptx, abre em qualquer aplicativo de apresentação) a partir de um ou mais roteiros. O formato padrão da casa está embutido no construtor, portanto não é necessário modelo ou deck de referência. Use sempre que alguém compartilhar um roteiro (texto, PDF ou planilha) e pedir um deck de pré-produção, mesmo que diga apenas "monte a pré-pro" ou "passe pelo processo". Uma seção completa por roteiro. Nunca retorna um deck parcial.

O que é Construtor de Deck de Pré-Produção?

O Construtor de Deck de Pré-Produção é uma skill especializada em IA agente (como Claude Code, Cursor ou Codex) que transforma um ou mais roteiros (texto, PDF ou planilha) em um deck de pré-produção profissional no formato .pptx, pronto para ser aberto em qualquer aplicativo de apresentação. O formato da casa é fixo e não requer modelo externo, garantindo consistência visual e de conteúdo. A skill é acionada sempre que um usuário solicita um deck de pré-produção, storyboard ou shooting deck, processando cada roteiro como uma seção completa e independente. O processo inclui intake inteligente (coleta de marca, deliverables, dias de gravação, produtos e escolha de tema visual), estruturação padronizada do deck (capa, overview, abordagem criativa, cinematografia, design de produção, figurino, storyboards e agradecimentos), redação detalhada de cada slide no tom de diretor de produção, verificação legal de alegações, e construção final via script Python. A skill também suporta a inserção de imagens reais ou geração de prompts de IA. Cada resposta passa por uma revisão dupla antes de ser apresentada ao usuário, garantindo qualidade e aderência às regras.

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

Perguntar na sua IA favorita

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

Documentação

O que Construtor de Deck de Pré-Produção faz?

Roteiro entra. Deck de pré-produção sai. O formato é fixo. O texto é o ofício.

1. Intake

Pergunte uma vez, apenas pelo que estiver faltando:

  • Roteiro(s). Ignore abas de rascunho ou teste. Pergunte se uma aba não estiver clara.
  • Nome da marca, exatamente como o cliente escreve.
  • Entregáveis com quantidades (exemplo: 30s Hero Video (x3), 15s Cutdown (x3)). Nunca invente quantidades.
  • Dias de gravação e locações, se conhecidos. Quais roteiros compartilham o mesmo dia.
  • Lista de produtos com SKUs ou IDs de produtos, se o roteiro nomear produtos.
  • Visual. O padrão é a própria marca do cliente (veja abaixo). Se nada ainda estiver disponível, ofereça:
    • sky: divisores com gradiente azul-céu, Avenir. Um placeholder neutro até que as cores da marca sejam definidas.
    • ink: divisores preto e carvão, Helvetica. Editorial, premium, tech.
    • sage: divisores verde suave, Georgia. Calmo, natural, bem-estar e lar.
    • custom: eles enviam um brand book, logotipo, capturas de tela ou um site. Extraia duas cores para divisores, cor do texto e fonte. Mostre as escolhas como códigos hex e confirme antes de construir. Se uma fonte da marca não estiver instalada na máquina do visualizador, nomeie uma fonte de sistema similar e informe. Se eles não escolherem e não houver marca disponível, use sky.

Marca primeiro. Azul-céu é apenas o substituto. Antes de construir, procure as cores do cliente: um brand book, logotipo ou capturas de tela que o usuário compartilhar, ou o site da marca. Extraia duas cores para divisores, a cor do texto e a fonte, mostre-as como códigos hex e confirme. Use azul-céu apenas quando ainda não houver marca disponível, e diga na entrega que é um placeholder para ser substituído pelas cores da marca. Escreva azul-céu no spec como "theme": {"base": "gold", "a": "56B4E9", "b": "1F7DC4"}. Nunca use a paleta amarelo-ouro.

2. Estrutura do deck

Capa                 nome da marca, na cor da marca
Visão Geral          o que é a campanha, para quem fala, depois Entregáveis
Abordagem Criativa   o insight, como cada spot puxa um fio, onde cada spot termina
Cinematografia       compartilhada, apenas se uma abordagem de câmera servir para todos os spots
-- por roteiro --
Divisor              nome do spot; subtítulo opcional (linha temática ou "Dia 1")
Cinematografia       para este spot, a menos que compartilhada
Locação              placeholder para seleções de locação
Design de Produção   para este spot
Elenco               placeholder para seleções de elenco
Figurino             para este spot
Storyboards          3 frames por slide
--
Agradecimentos

As cenas são numeradas por roteiro: roteiro 1 = 101, 102... roteiro 2 = 201... Nunca quebre a ordem dos roteiros. Roteiros que compartilham um dia de gravação podem compartilhar uma seção de Cinematografia, Design de Produção e Figurino. Informe isso no divisor ("Roteiros 1 e 3 / Dia 1").

3. Escrevendo cada slide

Tom: um diretor escrevendo para a equipe. Parágrafos curtos e ponderados de duas a quatro frases completas na linguagem da produção: lente, cobertura, luz, bloqueio, textura, cenografia, ritmo. Cada parágrafo diz à equipe algo que eles possam filmar, construir ou comprar, e por que isso importa para a história. As frases se conectam e constroem. Nunca acumule fragmentos ou escreva linhas que soem como slogans. Sem enchimento, sem travessões, sem "elevar", "perfeito", "imersivo".

Visão Geral (80 a 120 palavras antes dos Entregáveis). Um parágrafo curto sobre o que é a campanha e o mundo em que vive, um segundo sobre para quem fala e o que deve motivá-los a fazer. Depois o bloco de Entregáveis, uma linha por formato.

Abordagem Criativa (100 a 150 palavras). Comece com o insight como um pensamento completo, não um slogan. Depois uma ou duas frases por spot sobre o fio que ele puxa e como se desenrola na tela. Termine onde cada spot termina (cartão final, URL, tagline).

Cinematografia (3 parágrafos curtos, 40 a 55 palavras cada). Como a câmera se move e por quê. Tamanhos de plano e quando usar plano geral. O que os inserts devem mostrar e quão legíveis eles são. Luz. Amarre movimento à emoção: quando se move, quando para.

Design de Produção. Formato fixo:

  • Linha de cabeçalho: NOME DO SPOT · TAGLINE CURTA em maiúsculas.
  • Duas frases de clima: como o espaço deve parecer, e por quê.
  • Os Cenários: cada cenário em uma ou duas frases. Detalhes de uso (sapatos perto da porta, desenhos na geladeira).
  • Paleta: 3 ou 4 cores, mais onde a cor da marca aparece em lugares pequenos e reais.
  • Adereços Essenciais: agrupados, 2 a 4 linhas. Produto herói primeiro, com cor e SKU. Listas longas vão nas notas, não no slide.

Figurino. Formato fixo:

  • Duas frases de clima para a locação ou spot.
  • Uma linha por personagem: Nome (Sexo, Idade): o que veste, e um detalhe que conta a história. Crianças recebem idades exatas. Adultos recebem uma faixa (Final dos 30, Meados dos 20).
  • Linha Paleta:.
  • Sem logotipos, a menos que sejam do cliente.

Storyboards. Cada frame tem:

  • VISUAL: slugline quando a cena muda (INT. COZINHA - DIA). Nomes de personagens em maiúsculas na primeira aparição, com idade. Depois 2 a 3 frases completas de direção: a ação, o enquadramento e qualquer movimento de câmera. Use INSERT: para close-ups de tela e produto, CORTE PARA: para cortes secos, NOTA: para algo imperdível. Nomeie o produto com seu SKU.
  • VOICEOVER | TEXTO: linhas VO: ipsis litteris do roteiro. TEXTO: para texto na tela. SFX: e MÚSICA: quando o roteiro os chamar. ALT: para uma linha de backup.
  • Último frame é o cartão final. Adicione fotos da família de produtos ou variações de cor como cenas extras após ele.
  • Preserve o VO e os nomes de marca exatamente como no roteiro. Sinalize contradições. Nunca corrija silenciosamente.

4. Ajuste

As caixas não encolhem automaticamente. Corte palavras, nunca o tamanho da fonte.

  • Design de Produção: cabeçalho, clima, 2 blocos curtos, 2 a 4 linhas de adereços.
  • Figurino: clima, 1 linha por personagem, paleta.
  • Cinematografia: 3 parágrafos, cerca de 40 a 55 palavras cada.
  • Visual do storyboard: cerca de 45 a 55 palavras. VO e texto: cerca de 25.

5. Sinalizações legais

Antes de construir, verifique o roteiro em busca de estatísticas, superlativos, preços, ofertas, alegações de saúde ou dinheiro, depoimentos e marcas de terceiros. Mantenha a linha como escrita, adicione uma versão mais segura ALT: e liste cada sinalização na entrega. Isenções de responsabilidade obrigatórias vão em TEXTO: com um asterisco. Esta é uma primeira verificação, não aconselhamento jurídico.

6. Construção

Escreva um JSON spec, depois execute:

python scripts/build_deck.py spec.json outputs/<Marca>_PrePro_v1.pptx

Formato do spec:

{
  "brand": "Nome da Marca",
  "theme": {"base": "gold", "a": "56B4E9", "b": "1F7DC4"},
  "cover_sub": "opcional",
  "overview": ["linha", "", "Entregáveis:", "30s Hero Video (x1)"],
  "creative_approach": ["linha", "", "linha"],
  "shared_cinematography": ["opcional; omitir para escrever por spot"],
  "scripts": [{
    "title": "Nome do Spot", "subtitle": "opcional", "base": 101,
    "cinematography": ["linha"],
    "production_design": ["SPOT  ·  TAGLINE", "clima", "", "Os Cenários", "linha", "", "Paleta", "linha", "", "Adereços Essenciais", "linha"],
    "wardrobe": ["clima", "", "Nome (Sexo, Idade): linha", "", "Paleta: linha"],
    "location_placeholder": true, "casting_placeholder": true,
    "frames": [{"vis": "INT. SALA - DIA\nAção.", "vo": "VO: linha", "title": "TEXTO NA TELA"}]
  }]
}

theme são as cores da marca como um dicionário, azul-céu como acima quando nenhuma marca está definida, ou a palavra ink ou sage. Ele define as cores de gradiente do divisor (a, b), texto do corpo (ink), rótulos (grey), placeholders (ph), cor do título do divisor (title) e font. Qualquer chave omitida recai para o estilo base.

Um exemplo completo está em references/example_spec.json.

"" é uma linha em branco. Cabeçalhos de seção (Entregáveis:, Os Cenários, Paleta, Adereços Essenciais) e linhas de cabeçalho em maiúsculas ficam em negrito automaticamente. No Figurino, o texto antes do primeiro dois-pontos fica em negrito.

7. Imagens (último passo, apenas depois que o deck for aprovado)

Não levante imagens até que o usuário aprove o deck. Depois, ofereça dois caminhos em uma linha:

A. Imagens próprias. Eles enviam frames de storyboard, fotos de locação, headshots ou fotos de produto. Nomeie ou mapeie cada uma para uma chave, coloque em uma pasta e reconstrua: python scripts/build_deck.py spec.json out.pptx --images <pasta> As imagens são cortadas para preencher cada espaço. Espaços vazios permanecem como placeholders.

B. Pacote de prompts de IA. Execute python scripts/make_prompts.py spec.json <Marca>_Image_Prompts.md. Escreva image_style no spec primeiro: uma linha sobre aparência, luz, paleta e proporção, extraída do texto de Cinematografia e Design de Produção. Entregue o arquivo. Eles colam os prompts em qualquer ferramenta de imagem, salvam cada imagem com a chave como nome, enviam e você reconstrói com --images.

Chaves de imagem:

  • Frame de storyboard: o número da cena (101, 102, 201).
  • Slides de conteúdo: <chave-roteiro>-design-1, -design-2, -wardrobe-1, -wardrobe-2, -cine-1, -cine-2.
  • Locação e elenco: -location-1 a -3, -casting-1 a -3.
  • A chave do roteiro padrão é s1, s2... pela ordem dos roteiros. Defina "key" em um roteiro para sobrescrever.

Nunca gere imagens de pessoas reais e nomeadas ou personagens com marca registrada. Espaços de elenco são para as próprias fotos de talento do usuário.

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 exigente o faria, de acordo com a lista de verificação abaixo e cada regra nesta skill. Leia o texto como se ouvisse 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 produza algo: pesquisa, opções, texto, specs e arquivos. Para um arquivo, construa, abra ou renderize, verifique, depois corrija e reconstrua antes de entregar.

Lista de verificação

  • O deck usa as cores da marca do cliente, ou azul-céu nomeado como placeholder na entrega. Nunca amarelo.
  • Cada roteiro tem sua seção completa. Números de cena em ordem. VO e nomes de marca correspondem exatamente ao roteiro.
  • O texto é lido como parágrafos ponderados em linguagem de produção. Sem fragmentos de slogan.
  • Renderize o deck e olhe cada slide. Nada escapa de uma caixa. Nenhum texto placeholder.
  • Sinalizações legais listadas. Nenhum nome que o usuário não forneceu. Nenhum travessão.

8. Verifique, depois entregue

  • Cada roteiro tem sua seção completa. Números de cena em ordem. Nada escapa de um slide (renderize com soffice e pdftoppm se disponível).
  • Nenhum texto placeholder, nenhum nome que o usuário não forneceu, nenhum travessão.
  • Entregue em 3 linhas: contagem de slides, roteiros e slides de storyboard, depois sinalizações legais e perguntas em aberto.
  • Imagens, seleções de elenco e locação são inseridos manualmente. Informe isso.
  • Nunca adicione nomes de equipe, talento ou contato sem perguntar.

Individual skills in this repo

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

Habilidades Relacionadas