Communitygithub.com

storyboard-de-filme

Escreva a história de um filme de produto como beats (o que o espectador vê, as palavras na tela, a voz, o som, por que o beat existe e onde cada afirmação é comprovada) e envie para o proprietário como um storyboard de uma página com quadros para revisão, com 2–4 direções quando a história estiver aberta. Estágio 2 de product-film, e o formato de revisão reutilizado para a narração. Use ao planejar a história, o roteiro de cenas ou o script de um filme de lançamento/promoção, ou quando o proprietário disser "me dê um storyboard", "me dê direções", "vou revisar e decidir".

O que é storyboard-de-filme?

O **storyboard-de-filme** é uma habilidade especializada para a criação de storyboards de filmes de produtos, parte do fluxo de trabalho **product-film**. Ele ajuda a planejar a história visual e sonora de um filme promocional, definindo cada "beat" (cena) com detalhes como imagem, texto na tela, narração (voiceover), som e a justificativa de cada elemento. A ferramenta garante que cada afirmação feita no filme seja lastreada por uma prova (arquivo, documento ou teste) e que a história siga princípios de qualidade como especificidade, realismo e clareza, evitando erros comuns identificados em rascunhos anteriores. O processo começa com a leitura do briefing aprovado e referências, seguido pela criação de um arquivo `storyboard.json` com os beats e 2–4 direções criativas diferentes. Um script Python gera uma página HTML (`storyboard.html`) para revisão visual, com cada narração em parágrafo único (leitura de olhos fechados) e cada beat com seu quadro. Após aprovação do proprietário, o `storyboard.json` se torna a fonte da verdade para o resto da produção. A habilidade suporta plataformas como Claude Code (via `~/.claude/skills/`), Cursor e Codex, sendo executada localmente com Python 3. Ela é essencial para quem precisa planejar um filme de lançamento ou promoção de produto de forma estruturada e colaborativa, reduzindo retrabalho e garantindo que a história seja aprovada antes da renderização cara.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aqeelshamz/product-film-skills/tree/HEAD/film-storyboard

Perguntar na sua IA favorita

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

Documentação

Storyboard de filme

O storyboard é onde a maioria das correções do proprietário deve acontecer, porque mudar uma frase custa um minuto e mudar uma cena renderizada custa uma hora. Envie-o antes de construir e envie-o novamente (com quadros reais) antes de gravar uma narração.

O que faz uma boa história de filme de produto

Verifique cada beat contra estes pontos. Cada um veio de um rascunho rejeitado (veja product-film/references/lessons.md).

  1. A dor do espectador, no dia a dia dele. Nomeie o hábito ou incômodo como o espectador diria. Teste a linha: depois de ouvi-la, o que um estranho acharia que vendemos? "Os mesmos números todo dia" fez as pessoas pensarem em software de análise, então falhou.
  2. Funções não podem ser mal interpretadas. Mostre ferramentas reais com nome e logotipo. Verifique cada par de linhas adjacentes: "Pergunte à IA que você já paga. Ela se chama Nimbet." faz o produto parecer a IA. Associe o nome ao que o produto faz.
  3. Específico, não abstrato. "Sua IA" como rótulo não era claro; a janela real do Claude Desktop era clara. Um painel real do Stripe supera uma caixa rotulada "Receita".
  4. Variedade precisa de espaço. Se a promessa é "o que VOCÊ precisar", mostre 8+ tipos de pessoas (um cartão de tela cheia cada), depois uma parede com muitos itens misturando trabalho, vida e diversão (jogos, animais de estimação, adesivos). Menos de ~6 "parece travado". Isso precisa de 45–65 s; 20 s é muito curto.
  5. Apenas real. Cada item, capacidade e afirmação funciona no produto hoje. Preencha o campo claim com onde é comprovado (um arquivo, um documento, um teste). Se a história precisar de algo que o produto não pode fazer, levante com o proprietário: construa ou corte.
  6. Entenda cada cena antes de escrever sobre ela. Escreva o why para cada beat. Se você não consegue dizer para que serve uma cena, pergunte ao proprietário. (Uma linha sobre animal de estimação foi escrita sobre uma cena que na verdade mostrava os widgets personalizados das pessoas.)
  7. Cada linha legível. Texto na tela: ~0,3 s por palavra + 1 s, nunca menos de 1,5 s totalmente visível.
  8. Termine na ação, com o nome e a URL, e a linha de uso nominativo se alguma marca apareceu.

Passos

  1. Leia o briefing aprovado, reference/NOTES.md, o produto e site ao vivo, e o arquivo de lições.
  2. Rascunhe beats em storyboard.json (formato no cabeçalho do script):
    { "title": "…", "subtitle": "rascunho 1 · 16:9 · 60 s", "directions": ["A · …", "B · …"],
      "beats": [{ "t": "0.0–4.0", "still": "review/sketches/01.png", "picture": "…", "onscreen": "…",
                  "vo": {"A · …": "…", "B · …": "…"}, "sfx": "…", "why": "…", "claim": "…" }] }
    
    Antes do filme existir, still pode ser um esboço rápido ou um quadro da referência com uma nota; depois, sempre um quadro REAL renderizado (node scripts/render.mjs --at …).
  3. Direções. Quando o ângulo estiver aberto, escreva 2–4 direções que diferem em ideia, não em redação (por exemplo, "Dicas que o espectador pode usar", "O incômodo diário", "O que sua IA já sabe sobre você"). Para cada: ideia em uma linha, o risco e para quem serve. Coloque sua escolha primeiro.
  4. Construa a página:
    python3 ~/.claude/skills/film-storyboard/scripts/storyboard.py storyboard.json review/storyboard.html
    
    Ela abre com a narração de cada direção como um parágrafo (a leitura de olhos fechados), depois cada beat com seu quadro.
  5. Autoverificação antes de enviar: leia apenas o parágrafo da transcrição. Faz sentido com os olhos fechados? Alguma linha que poderia ser mal interpretada? Alguma lista de "seu X, seu Y", tríade ou palavra repetida? Alguma afirmação sem prova?
  6. Portão de revisão. Envie a página (SendUserFile, exiba renderização) e pergunte: qual direção e quais beats mudar. Adicione as perguntas do estágio 2 de product-film/references/question-bank.md (abertura, como as funções são mostradas, formato da persona, personagens, realismo da interface). Aguarde um sim claro. Faça commit de storyboard.json.

Após a aprovação

Mantenha storyboard.json como a fonte da verdade: a temporização das cenas no filme e a colocação das frases na narração vêm dele. Quando o proprietário mudar um beat depois, altere-o aqui primeiro e regenere a página.

Individual skills in this repo

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

film-build

Build a product film in code as a deterministic seek(t) web page (real product UI, real OS chrome, kinetic text, typed prompts, a cursor, morphs and camera moves), review it as stills and drafts, render it at 60 fps with motion blur, and adapt it to 9:16 without changing 16:9. Ships a project kit (init.sh, film engine, render/sync/probe/sheet/regression tools). Stage 3 and 6 of product-film. Use when building, fixing or rendering the picture of a launch/promo film, or making its vertical version.

film-sound

Add sound to a finished product-film picture with real recorded sound effects (CC0 packs such as Kenney's) placed only on real on-screen events, decide with the owner whether there's a music bed, mix to -14 LUFS and mux into the renders without re-rendering. Stage 4 of product-film. Use when a film's picture is approved and needs sound effects or music, or when the owner says the sounds feel fake, synthetic or "AI slop".

film-voiceover

Write, review, test and record the voiceover for a product film after its picture is approved, as a script on a storyboard of the film's real frames, with directions to choose from, an eyes-closed coherence check, a pronunciation test for the product name, TTS recording per section (Fish Audio), phrase placement on the film's timeline, mixing and muxing. Stage 5 of product-film. Use when a launch/promo film needs narration, or the owner says the voiceover sounds like AI, doesn't match the frames, or mispronounces the name.

product-film

Make a product launch / promo / explainer film that sells and does not look or sound AI-made, through review gates the owner signs off one at a time. Study a reference video for its grammar (never copy it), then storyboard, build the film in code, add sound, write and record the voiceover, and deliver 16:9 and 9:16. Use when someone wants a launch video, promo, product film, explainer, ad, "a video like this one" for their product, or says the last video looked like "AI slop" or "vibe coded". Entry point for the film-* skills (film-reference-study, film-storyboard, film-build, film-sound, film-voiceover).

Habilidades Relacionadas