Communitygithub.com

filme-produto

Crie um vídeo de lançamento / promoção / explicativo para um produto que venda e não pareça ou soe como feito por IA, passando por pontos de aprovação que o proprietário aprova um de cada vez.

O que é filme-produto?

Esta skill orienta a criação de um vídeo de produto profissional e realista, evitando os clichês que fazem um vídeo parecer "feito por IA" ou "vibe coded". O processo é estruturado em estágios sequenciais (Brief, Referência, Storyboard, Imagem, Som, Locução, Formatos, Entrega), cada um com um ponto de aprovação explícito do proprietário. A skill utiliza um conjunto de skills auxiliares (`film-reference-study`, `film-storyboard`, `film-build`, `film-sound`, `film-voiceover`) para cada etapa, garantindo que o vídeo seja construído em código, com sons e locução reais, e entregue nos formatos 16:9 e 9:16. O foco está em regras rigorosas de realismo (tudo deve funcionar no produto atual), especificidade (logotipos reais, UI detalhada), e na perspectiva do comprador, evitando qualquer traço de conteúdo genérico ou sintético. O proprietário é o juiz final, e cada correção é registrada em `references/lessons.md` para melhorar os projetos futuros.

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

Perguntar na sua IA favorita

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

Documentação

Filme de produto

Um filme de produto é julgado por uma pessoa primeiro: o proprietário. Eles corrigem o que está errado, você conserta, e o filme melhora uma rodada de cada vez. Esta skill existe para que você torne as correções do proprietário desnecessárias: cada regra aqui veio de uma correção que alguém teve que fazer manualmente. Leia references/lessons.md antes de começar, e novamente antes de cada revisão que você enviar. É o registro do que os proprietários rejeitaram e por quê.

O pipeline e seus pontos de aprovação

Nada passa para o próximo estágio até que o proprietário tenha aprovado o atual. Aprovação é um "sim" claro no chat, não silêncio e não "parece bom, mas…". Após qualquer alteração solicitada pelo proprietário, envie novamente para revisão.

EstágioSkillVocê envia para revisãoPonto de aprovação
0 · Briefesta aquio brief: produto, comprador, a única coisa para convencê-los, duração, formatos, onde será exibidoproprietário aprova o brief
1 · Referênciafilm-reference-studyo que a referência faz e o que pegar emprestado, como números e quadrosproprietário concorda com o que é emprestado e o que não é
2 · Storyboardfilm-storyboarduma página de storyboard: um quadro por batida, palavras na tela, por que cada batida está ali; 2–4 direções se a história estiver em abertoproprietário escolhe uma direção e aprova as batidas
3 · Imagemfilm-buildprimeiro imagens estáticas, depois um rascunho em 30 fps, nunca uma renderização final primeiroproprietário aprova a imagem ("renderizar final")
4 · Somfilm-soundo final com efeitos sonoros, e a decisão musicalproprietário aprova o som
5 · Locuçãofilm-voiceovero roteiro em um storyboard de QUADROS REAIS, depois testes de nomes, depois a versão com locuçãoproprietário aprova roteiro, pronúncia, depois a versão final
6 · Formatosfilm-build (formatos)imagens estáticas 9:16, depois a renderização 9:16proprietário aprova; 16:9 comprovadamente inalterado
7 · Entregaesta aquios arquivos, legendas, créditos, o que não está verificadoconcluído

"Antes de renderizar, deixe-me revisar": o proprietário quer ver o plano e as imagens estáticas antes de você gastar 30 minutos em uma renderização. Uma renderização final sem um rascunho aprovado é tempo perdido e desperdiça a confiança deles.

Como perguntar (em cada ponto de aprovação)

Em cada ponto de aprovação, faça perguntas com opções concretas em vez de perguntas abertas, e torne cada opção algo que um editor real escolheria. Opções genéricas ("moderno", "limpo", "dinâmico") são como um filme se transforma em "AI slop". O arquivo references/question-bank.md tem as perguntas e opções para cada estágio: visual, movimento, ritmo, transições, digitação, personagens, som, música, voz, entrega. Regras:

  • Duas a quatro opções por pergunta, cada uma com sua aparência ou som e seu custo ou risco. Coloque sua escolha primeiro e diga por que em uma linha.
  • Pergunte apenas o que muda o trabalho. Decida o resto a partir da marca e da referência, e diga o que decidiu.
  • Quando o proprietário falar ideias em voz alta, não implemente cada frase. Pesquise, depois volte com 2–4 direções e suas compensações, e deixe-os escolher ("me dê algumas direções com as compensações para que eu possa decidir").
  • Quando o proprietário disser "espere, vou te contar mais", pare e aguarde. Não continue editando.
  • Quando uma correção chegar, encontre a regra por trás dela e verifique todo o filme pelo mesmo erro, não apenas o ponto específico que eles apontaram.

Regras que valem em todos os estágios

  1. Real apenas. Cada recurso, widget, tela, fonte de número e afirmação no filme funciona no produto hoje. Se o filme precisar de algo que o produto não pode fazer, ou construa no produto (e registre a decisão) ou remova. Cada afirmação falada ou mostrada tem uma fonte que você pode apontar (um arquivo, um documento, um teste).
  2. Específico, não genérico. Logotipos reais dos sites das próprias marcas. Chrome do SO real com aplicativos que realmente existem naquele SO. Tamanhos de dispositivos reais. Papéis de parede reais (licenciados). UI de produto rica e detalhada: "muito simples" parece "por que eu pagaria por isso". Veja film-build/references/realism.md.
  3. O ponto de vista do espectador. O filme é para um estranho que nunca ouviu falar do produto. Teste cada batida: eles entenderiam? Poderiam interpretar errado (por exemplo, pensar que o produto É a IA)? É sobre a vida deles ou sobre nossos recursos?
  4. Não feito por IA. Sem bipes sintetizados, sem maquetes minimalistas, sem imitações de marcas reais em fontes de ícones, sem tríades e textos "seu X, seu Y", sem locução descrevendo cenas. Os proprietários conhecem esses sinais, e seus compradores também. Um concorrente foi publicamente criticado por um vídeo de lançamento que parecia "feito com Claude".
  5. Legível e suave. Cada linha permanece tempo suficiente para ser lida até o fim. A digitação parece de um teclado. Nada corta, sobrepõe ou pisca vazio. Ritmo para humanos: os primeiros cortes são quase sempre muito rápidos.
  6. Determinismo. O filme é uma função pura do tempo; render.mjs --verify deve passar antes de qualquer renderização que você enviar.
  7. Relatórios pequenos e honestos. Ao enviar uma revisão, diga o que mudou, o que ainda está em aberto e o que você não pôde verificar (você não pode ouvir áudio: diga isso e pergunte). Nunca chame algo de verificado que você não verificou.
  8. Commite com frequência (código, scripts, storyboard, roteiro de locução). Renderizações, áudio e imagens estáticas ficam fora do git.

Estrutura do projeto

<filme>/
  brief.md                 estágio 0
  reference/               saída do estudo (quadros, planilhas, summary.md, NOTES.md)
  storyboard.json          fonte do estágio 2 → review/storyboard.html
  film/                    a página do filme (core.js, film.js, mock.js, index.html)
  scripts/ tools/          render, sync, som, voz, mix, sondas (do kit do film-build)
  timeline.json vo.json    temporização da imagem e cues de som; frases da locução
  VO-SCRIPT.md             a locução aprovada com de onde vem cada afirmação
  assets/                  fontes, logotipos, papéis de parede, efeitos sonoros, personagens, CREDITS.md
  renders/ audio/ review/  (ignorados pelo git)

Comece com sh ~/.claude/skills/film-build/kit/init.sh <filme>.

Estágio 0 · Brief

Antes de qualquer outra coisa, escreva brief.md e obtenha aprovação:

  • Produto, em uma frase que um estranho entenda. Não o slogan.
  • Quem compra, nas palavras deles. Vários tipos de pessoas se o produto atender a vários (personas): o que cada um verifica ou precisa todos os dias.
  • A única coisa que o filme deve convencê-los, e o único equívoco que deve evitar.
  • Prova disponível: o que é real hoje, o que foi construído e gravado, o que pode ser mostrado.
  • Duração e formatos: um filme de lançamento que mostre variedade precisa de cerca de 45–65 s. 20 s é muito curto para mostrar várias pessoas e seus casos de uso. Formatos: 16:9 primeiro, depois 9:16, a menos que o proprietário diga o contrário.
  • Onde será exibido (site hero, X, Reels, YouTube) e as regras da marca (cores, tipo, palavras nunca usar, logotipos).
  • O que o produto nunca deve ser mostrado como (por exemplo, "nunca como um dock"), e qualquer concorrente a evitar.

Estágio 7 · Entrega

  • renders/16x9.mp4 e renders/9x16.mp4 (60 fps, motion blur, voz e som mixados).
  • assets/CREDITS.md: cada papel de parede, logotipo, fonte, som e personagem, com sua licença.
  • Se marcas aparecerem: uma linha de uso nominativo na tela enquanto são exibidas ("Nomes de produtos e logotipos pertencem a seus proprietários…").
  • Uma lista simples do que não está verificado (por exemplo, "as quatro solicitações ainda não foram construídas no aplicativo real").
  • Legendas e uma miniatura, se solicitado (use as habilidades sociais e de redação do proprietário; sem sinais de IA).

Após o filme

Adicione cada nova correção que o proprietário fez a references/lessons.md, sob o estágio ao qual pertence, com o que estava errado e a regra que o impede. Esse arquivo é como o próximo filme começa à frente deste.

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-storyboard

Write the story of a product film as beats (what the viewer sees, the words on screen, the voice, the sound, why the beat exists, and where each claim is proven) and send it to the owner as a one-page storyboard with frames for review, with 2–4 directions when the story is open. Stage 2 of product-film, and the review format reused for the voiceover. Use when planning a launch/promo film's story, shot list, or script, or when the owner says "give me a storyboard", "give me directions", "I'll review and decide".

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.

Habilidades Relacionadas