Communitygithub.com

film-build

Cria um filme de produto em código como uma página web determinística seek(t) (UI real, chrome do SO, texto cinético, prompts digitados, cursor, morphs e movimentos de câmera), revisa-o como stills e rascunhos, renderiza a 60 fps com motion blur e adapta para 9:16 sem alterar 16:9. Inclui um kit de projeto (init.sh, engine, ferramentas de render/sync/probe/sheet/regression). Estágio 3 e 6 de product-film. Use ao construir, corrigir ou renderizar o visual de um filme de lançamento/promo, ou ao fazer sua versão vertical.

O que é film-build?

O film-build é uma skill de agente de IA especializada em construir filmes de produto em código puro, utilizando HTML, CSS e JavaScript para criar uma página web determinística que se comporta como um quadro de filme baseado no tempo (t). Ela oferece uma engine que garante determinismo visual: cada quadro é uma função pura do tempo, sem animações CSS, transforms 3D ou randomização, resultando em reprodução consistente entre renderizações. A skill fornece um kit completo com helpers para câmera, texto cinético (typed/keyed), cursor realista, sprites de personagens, e morphs, além de ferramentas de renderização (60 fps com motion blur), sincronização de timeline, revisão automática (contact sheets, fastest-action strips) e regressão visual (PSNR). O fluxo de trabalho é orientado por revisões: começa com stills, passa por QA rigoroso, envia rascunhos e finaliza com renderização em background. Suporta adaptação para formato 9:16 sem alterar o 16:9 original, usando um sistema de empacotamento de código (pk). É ideal para agentes que precisam criar filmes de lançamento ou promoção de alta qualidade, com ênfase em realismo de UI, chrome do SO e consistência temporal. As plataformas suportadas são ambientes node.js com Playwright para Chromium.

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

Perguntar na sua IA favorita

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

Documentação

Film build (Construção de Filme)

Início

sh ~/.claude/skills/film-build/kit/init.sh marketing/videos/<filme>   # recusa uma pasta não vazia
cd marketing/videos/<filme> && npm i && npx playwright install chromium   # se disser NEXT

O kit fornece a você:

ArquivoO que é
film/core.jsa engine: scene({name, from, to, build, run, after}) (tempos em beats = s × 2), put(el, {o, css}), reg(el, base), C.W/C.H/C.FMT, C.start()
film/film.jsum inicializador com todos os helpers abaixo e quatro shots de exemplo (linha, prompt, divisão, cartão de persona). O comentário de cada helper diz de qual rejeição veio. Substitua os shots, mantenha os helpers.
film/mock.jswindow.MOCK: HTML para peças reais de UI (dashboards, janelas, telas de celular), em px de tela
film/index.htmlcarrega fontes de assets/fonts/{display,ui}.woff2 (com fallbacks sans locais)
scripts/render.mjs--sheet, --at t1,t2, --draft, --range a,b, --verify, final, --mux, --fmt 9x16, --all
scripts/sync.mjscopia timeline.json para a página
scripts/review.pykit de crítica a partir do MP4 renderizado: contact sheet, tiras de ação mais rápida, visualização de telefone, zonas seguras 9:16, métricas
tools/probe.mjscuts (cada corte e o ponto médio de cada shot, em segundos de vídeo) ou qualquer expressão, ex.: "window.UNWARP(12.4)"
tools/sheet.pyorganiza stills em uma única folha legendada
tools/pack_grid.pycorta uma folha de personagem 4×3 (transparente ou em branco) em uma tira de 12 células para sprite(); imprime o tamanho da célula
tools/cut_cast.pycorta uma fila de uma linha em stills de personagens individuais
assets/characters/quatro personagens de exemplo (fundador, desenvolvedor, vendedor, estudante), tiras de 12 quadros com células de 360 px
tools/same.shsave / check regressão PSNR entre stills antes e depois

Helpers no inicializador (use-os, não reinvente)

  • io (quíntico in-out) para movimentos de câmera e morphs; oq (quíntico out) para entradas; back para um pequeno overshoot.
  • cam(e, s, fx, fy) coloca o ponto de foco (fx, fy) de um plano 1920×1080 no centro do quadro na escala s. camD faz o mesmo mas nunca mostra além das bordas do plano (escala de cobertura; essencial em 9:16).
  • posIn(e, root) lê a posição de um elemento dentro do plano em movimento (para alvos do cursor, acompanhamento de cursor).
  • typed() para palavras aparecendo letra por letra em uma linha; keyed() para um teclado real: temporização irregular por caractere, pausas mais longas em espaços, um cursor piscando depois.
  • wordsHTML() coloca cada palavra em sua largura final desde o primeiro quadro, transparente até seu momento, para que a linha nunca reflua ("transição de texto não é suave de jeito nenhum").
  • cursor()/putCursor()/bump(): um cursor de seta real que desliza, chega cedo, mergulha 15% em um clique.
  • pop() para itens pequenos pousando.
  • sprite(parent, src, cellW, cellH, h) / putSprite(e, t, a, z, loops) para um personagem desenhado: percorre seus 12 quadros de a a z, com uma pequena respiração para que nunca fique parado. É um <img>, então a engine espera por ele.
  • shot(name, t0, t1, build, run) envolve scene em segundos.
  • Warp de ritmo na parte inferior: SLOW (esticamento global), EV segura (congela um momento para leitura) e inserções; window.CUTS e window.UNWARP fornecem tempos de vídeo para posicionamento de som e voz.
  • PT / pk(a16, a9) escolhe valores por formato em um arquivo.

Regras da engine (determinismo)

O filme é uma função pura de t. Qualquer quadro deve pintar igual seja renderizado primeiro ou após qualquer outro quadro.

  • Apenas transforms 2D: sem translate3d, sem will-change, sem transições CSS, sem Math.random (use um hash de um índice).
  • Elementos ocultos no início: reg(el, {o: 0}), nunca opacity:0 inline.
  • Meça layout em after() ou uma vez em build, nunca dentro de run (ele lê o quadro anterior).
  • Visualizações 3D: reinsira cada quadro com insertBefore(v, firstChild) para que nenhum raster em cache sobreviva.
  • Animações CSS incorporadas (ex.: widget de produto próprio): pause-as e defina animation-delay: calc(-1s * var(--t)).
  • Aguarde imagens e fontes (decode(), document.fonts.ready) antes do primeiro quadro.
  • Escopo CSS do produto sob uma classe raiz única; use nomes de classe únicos no filme (.w vazou uma vez).
  • classList.add, nunca className =.
  • node scripts/render.mjs --verify deve imprimir 12/12 antes de qualquer renderização que você enviar.

Realismo: leia references/realism.md antes de construir qualquer tela

Versão curta: aplicativos reais em densidade real, logotipos reais dos próprios sites das marcas, chrome do SO com aplicativos que existem naquele SO, papéis de parede reais, telefones na grade real do launcher em tamanhos reais de dp desenhados pelo próprio renderizador do produto, UI do produto mais rica do que você pensa que precisa ser, uma linha de uso nominativo sempre que uma marca aparecer.

Loop de construção (orientado por revisão)

  1. Lista de shots do storyboard aprovado em film.js, um shot() cada, sobrepostos para transições.
  2. Stills primeiro. node tools/probe.mjs cuts → renderize um still no ponto médio de cada shot e em cada transição: node scripts/render.mjs --at … então python3 tools/sheet.py review/stills/16x9 review/sheet.jpg <tempos>. Leia a folha você mesmo. Corrija. Repita. (Cerca de 1–2 min por rodada, vs 25+ para uma renderização completa.)
  3. Passo de QA antes de QUALQUER revisão que você enviar: percorra o filme em ≤ 1,5 s e em cada transição (contact sheet de 10–15 fps sobre cada transição). Verifique references/qa.md linha por linha: sobreposições, clipping, quadros em branco, tempo de leitura, suavidade do texto, digitação, aviso de logotipo, realismo do SO, tamanhos de telefone.
  4. Envie stills (a folha) para o proprietário para a primeira olhada. Aguarde.
  5. Rascunho: node scripts/render.mjs --draft (30 fps, ~4 min), python3 scripts/review.py 1 --draft, leia as tiras. Envie o MP4 do rascunho. Diga claramente que é um rascunho de 30 fps sem blur (parece mais entrecortado que o final).
  6. Ao "renderizar final": node scripts/render.mjs em segundo plano (60 fps, motion blur; ~25–35 min para 60 s). Nunca edite film.js enquanto renderiza: copie o projeto primeiro se precisar continuar trabalhando.
  7. Commit código do filme e timeline após cada rodada aprovada.

Ritmo

Os primeiros cortes são quase sempre muito rápidos. Texto na tela precisa de cerca de 0,3 s por palavra + 1 s com opacidade total (nunca menos de 1,5 s). Prefira o warp (SLOW 1,1–1,25, EV segura em linhas) a reajustar o tempo de cada shot. Após qualquer mudança de ritmo, execute novamente probe.mjs cuts porque as posições de som e voz se movem.

9:16: leia references/formats.md

Reenquadre o mesmo filme em um arquivo com pk(); prove que 16:9 não foi alterado com tools/same.sh (cada still PSNR = inf); --verify --fmt 9x16; folha de stills para o proprietário; então --fmt 9x16 final em segundo plano, depois --mux --fmt 9x16.

Individual skills in this repo

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

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.

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