Vídeo de produto
Crie um vídeo de visão geral do produto, guiado por música, sem narração, construído como uma animação em HTML e renderizado quadro a quadro para MP4. Cada número, nome e diagrama na tela vem da saída real do produto. É isso que o torna credível e o diferencia de gráficos motion genéricos.
Como funciona: uma página HTML na resolução alvo define window.seek(t), que desenha o quadro no tempo t como uma função pura (sem animações CSS, sem timers). O Playwright chama seek(i/30) e captura cada quadro, e os quadros são enviados para o ffmpeg. Como os quadros não dependem do tempo real, a saída é idêntica em qualquer máquina, você pode pré-visualizar qualquer quadro individual e as alterações são renderizadas em minutos.
Arquivos incluídos:
scripts/render.mjs: composição para MP4 (--url --out [--w --h --fps --from --to])scripts/preview.mjs: imagens estáticas em momentos escolhidos, além de--sheetpara uma tira de contatoscripts/cutdown.py: reels curtos (ex.: 15s) cortados de uma composição existente: renderiza intervalos de tempo escolhidos, junta-os com cortes secos e coloca o drop da música no primeiro cortescripts/cues.mjs: deriva uma lista de sugestões de efeitos sonoros da composição (whooshes de cena, pops de cartão/chip, ticks de contador, cliques de cursor, o toque da URL, além dewindow.SFX_EXTRA)scripts/sfx.py: sintetiza o kit de som da interface do zero (clique, pop, whoosh, tick, tecla, toque, thud; sem áudio de estoque ou licenciamento), mixa as sugestões em uma faixa e faz a mixagem final de música + efeitos a -16 LUFSscripts/music.py:analyzeo mapa de energia de uma faixa emuxsob o vídeo (cortar, fade, -16 LUFS)scripts/doctor.mjs: verifica todos os requisitos abaixo e imprime a correção exata para qualquer item faltantescripts/_common.mjs: encontra um Chromium e ffmpeg pré-instalados (fallbackpip imageio-ffmpeg)assets/template.html: um modelo de cena funcional; um arquivo renderiza 16:9 e 9:16 através de uma media query retratoassets/fonts-manrope.css: fonte Manrope incorporada (fallback se o produto não tiver fonte incorporada)assets/examples/supersnapshot/: (Super Snapshot AI, uma ferramenta GoHighLevel) o código-fonte completo de um vídeo 80s finalizado (16:9 + vertical), um exemplo prático de cada padrão com polimento de produçãoreferences/story-and-copy.md: o arco da história, regras de manchete, regras de honestidade, convenções de tempo. Leia antes de storyboard.references/extraction.md: como encontrar uma fonte de dados segura e extrair SVGs, gráficos e capturas de tela do produto. Leia antes de capturar.
Requisitos
A skill executa comandos shell, então precisa do Claude Code (CLI, aplicativo desktop ou Claude Code na web). Um chat simples sem ambiente de código pode planejar um storyboard, mas não pode renderizar. Na máquina ou contêiner:
| Precisa | Por quê | Instalar |
|---|---|---|
| Node.js 18+ | executa os scripts de renderização | nodejs.org ou nvm install 22 |
pacote npm playwright, importável do diretório de trabalho | controla o navegador quadro a quadro | npm i -D playwright (muitos repositórios web já o têm) |
| Chromium | renderiza os quadros | npx playwright install chromium, ou reutilize um pré-instalado (CHROME=/path; /opt/pw-browsers é encontrado automaticamente) |
Python 3.9+ com numpy | síntese e mixagem de efeitos sonoros | pip install numpy |
| ffmpeg | codificação, música, mixagem | ffmpeg do sistema, ou pip install imageio-ffmpeg |
Acesso à rede só é necessário para instalar esses itens. A renderização é totalmente offline. O usuário fornece sua própria faixa de música; os efeitos sonoros são sintetizados, então não há nada para licenciar.
Fluxo de trabalho
0. Verifique a configuração
A partir do repositório do produto, execute node <skill>/scripts/doctor.mjs. Se algo mostrar ✗, execute a correção impressa (ou peça ao usuário, se você não puder instalar pacotes neste ambiente) antes de começar. Encontrar um ffmpeg ausente após uma build de 30 minutos desperdiça toda a sessão.
1. Encontre o material real
Leia references/extraction.md. Localize uma build de demonstração/exemplo do produto (scripts do repositório, fixtures ou uma URL de exemplo pública), abra-a no Playwright, clique em cada aba e despeje o texto de cada painel. Capture as telas dos painéis e observe-os. Você está caçando: o número real mais impactante (o gancho), os recursos pelos quais um comprador pagaria e os visuais que ficam bons em movimento.
2. Storyboard e obtenha um sim
Leia references/story-and-copy.md. Proponha uma tabela: # · tempo · o que está na tela · legenda na tela. Mantenha cerca de 60–75s (ou 30–45s para um corte social). Diga honestamente quais recursos parecem fracos na câmera. Pergunte as poucas coisas que apenas o usuário pode responder, e nada mais:
- algo a evitar mencionar,
- o CTA (padrão: apenas URL),
- o visual da marca (padrão: combinar com os tokens do próprio produto).
Aguarde a aprovação deles antes de construir, porque recortar uma renderização finalizada custa muito mais do que editar uma tabela.
3. Capture os assets
Coloque tudo em um diretório de trabalho temporário fora do repositório do produto (o scratchpad da sessão, se tiver um, senão um diretório temp): <work>/index.html + <work>/assets/. Extraia SVGs de diagramas, JSON de gráficos e capturas de tela de relatórios altos conforme descrito em extraction.md. Copie o CSS da fonte incorporada do produto para assets/fonts.css (ou assets/fonts-manrope.css desta skill).
4. Construa a composição
Copie assets/template.html para <work>/index.html. Substitua cada espaço reservado [BRACKETED] pelo conteúdo real, remova as cenas que não precisa e duplique as que precisa. Folheie o exemplo em assets/examples/supersnapshot/index.html para mais padrões (cartões de "problema" quentes, cartão de barra com caixa de chamada, mostrador de pontuação, mapa de dependência radial, rede de conta inteira, linhas de correção com tags de severidade).
Coisas que importam:
- O timing vive em dois lugares: tempos de início
SCENESedata-inde cada elemento. Se você inserir uma cena, desloque cadadata-inposterior e quaisquer tempos codificados emseek()na mesma quantidade (um pequeno regex sobredata-in="…"com valores ≥ o ponto de inserção resolve). - Crossfades: a nova cena aparece gradualmente sobre a antiga, que permanece sólida por baixo. Desvanecer ambas ao mesmo tempo faz com que cenas claras se tornem cinza lamacento.
- Revelações: as partes SVG aparecem na ordem de leitura (de cima para baixo, ou do centro para fora). As pontas de seta só aparecem depois que sua linha se estabeleceu. Destaque um nó pelo texto do rótulo.
- Chamadas: chips e rótulos nunca devem cobrir o que apontam. Coloque-os em espaço vazio ao lado e faça-os seguir se a câmera fizer pan.
5. Pré-visualize antes de renderizar
Sirva o diretório (cd <work> && python3 -m http.server 8765 &) e renderize imagens estáticas no momento chave de cada cena:
node <skill>/scripts/preview.mjs --url http://127.0.0.1:8765/index.html --dir <work>/prev --sheet 5 9 13 22 31 43 50 60
Observe cada quadro. Verifique sobreposições, quebras de linha estranhas (force com <br>), elementos aparecendo antes do que apontam, cartões vazios e texto placeholder deixado para trás. Corrija e pré-visualize novamente até ficar limpo. Os scripts precisam de playwright: execute-os a partir de um diretório cujo node_modules o tenha (o repositório do produto geralmente tem). Eles também encontram um Chromium pré-instalado por conta própria, então não execute playwright install.
6. Renderize e verifique
node <skill>/scripts/render.mjs --url http://127.0.0.1:8765/index.html --out <work>/video.mp4
Cerca de 3–5 minutos para 80s a 1080p30. Depois, extraia quadros do próprio MP4 nas transições de cena (ffmpeg -ss <t> -i video.mp4 -frames:v 1 x.jpg) para capturar problemas de transição que imagens estáticas isoladas perdem.
7. Música
Quando o usuário enviar uma faixa:
python3 <skill>/scripts/music.py analyze track.mp3 # encontre a introdução, o drop, as breakdowns
python3 <skill>/scripts/music.py analyze track.mp3 --zoom 14 17 # prenda o drop na batida
python3 <skill>/scripts/music.py mux video.mp4 track.mp3 out.mp4 [--offset s]
O objetivo é que o drop caia no corte da revelação da marca para a primeira cena de recurso. Escolha --offset (ou ajuste SCENES) para conseguir isso. Informe ao usuário onde caem os trechos silenciosos. Se uma cena de venda chave estiver em uma breakdown, sugira reordenar as cenas.
7b. Cursor e efeitos sonoros
Eles fazem o vídeo parecer um produto real sendo usado, mas apenas quando cada som tem algo na tela que o causa.
Cursor: a lista CURSOR do modelo define 2–4 momentos de clique. O cursor desliza até um elemento real (por seletor CSS, medido a cada quadro, então segue pans e funciona em ambas as orientações), pressiona e deixa uma ondulação. Cada clique deve causar o que se segue cerca de 0,1–0,3s depois: as barras preenchem, uma etapa destaca, um mapa se expande, a digitação começa. Mova o data-in da reação se precisar. Verifique nas pré-visualizações que o alvo já apareceu quando é clicado; clicar em um nó que ainda não foi desenhado parece quebrado. Se um alvo não tiver um seletor útil, dê a ele um id em init() (por exemplo, encontre um nó mermaid pelo texto do rótulo).
Sons:
node <skill>/scripts/cues.mjs --url http://127.0.0.1:8765/index.html --out <work>/cues.json
python3 <skill>/scripts/sfx.py mix <work>/cues.json --duration <DURATION> --out <work>/sfx.wav
python3 <skill>/scripts/sfx.py final <work>/video.mp4 --sfx <work>/sfx.wav --music track.mp3 [--offset s] --out <work>/final.mp4
cues.mjs coloca sons a partir do próprio timing da animação, então eles permanecem travados a ela após qualquer re-timing. Qualquer coisa que ele não consiga ver (contadores acionados por JS em vez de data-count, digitação, um gancho aterrissando) vai em window.SFX_EXTRA. Mantenha esparso: sem som nas entradas de manchete, uma execução de tick por grupo de contadores. Ganhos que funcionaram contra uma faixa corporativa movimentada: clique cerca de -1 dB, tecla cerca de -6, tick cerca de -8, pop -11, whoosh -10 a -14. Para verificar se um som não está soterrado, compare-o com a música na banda >2,5 kHz (passe-alto em ambos, compare picos); picos de banda completa enganam porque os graves da música dominam. Se os efeitos parecerem soterrados, abaixe --music-gain (padrão -6) antes de aumentar os ganhos dos efeitos. final define o volume com um ganho estático, pois um loudnorm dinâmico achataría os cliques. sfx.py kit <dir> escreve cada som como um WAV para audição.
8. Vertical 9:16
O modelo é consciente da orientação: renderize a mesma página com --w 1080 --h 1920 e a media query retrato assume (manchetes empilhadas acima de cartões de largura total, conteúdo chave mantido entre y≈250 e y≈1550, longe das sobreposições dos apps sociais). Use <br class="br-v"> para quebras de linha que devem ocorrer apenas no retrato. Para uma composição não construída a partir do modelo (como o exemplo), faça uma cópia vertical.html com posições de retrato. Pré-visualize os quadros do retrato também, pois as quebras de texto são diferentes.
9. Reels curtos (15s)
Depois que o vídeo vertical existir, corte 2–4 reels curtos dele. Cada um tem um ângulo (uma dor, um cluster de recursos), para que cada um possa ser testado como um anúncio ou post separado. Não reconstrua nada: escolha intervalos de tempo da composição vertical e deixe cutdown.py renderizá-los e juntá-los.
python3 <skill>/scripts/cutdown.py --url http://127.0.0.1:8765/vertical.html \
--seg 3.2-6.2 --seg 6.5-9.0 --seg 15.4-20.9 --seg 75.6-79.6 \
--out <work>/reel1.mp4 --music track.mp3 --drop 15.0 --sfx
--sfx puxa as sugestões de som de cada segmento da composição, reajusta o tempo para o reel e as mixa com a música.
Escolhendo segmentos (veja "Reels curtos" em references/story-and-copy.md):
- Forma: gancho (2,5–3s) → 1–2 batidas de recurso (4–5,5s cada) → cartão final (4s). Total 15s.
- Comece cada segmento depois que sua cena tiver desaparecido completamente (início da cena + cerca de 0,5s) ou em uma entrada chave, e termine depois que sua recompensa tiver sido entregue: contadores concluídos, o chip estourado, o destaque aceso. Verifique os tempos
data-in/contagem na composição. Um contador cortado no meio é o erro clássico. - Comece o segmento do cartão final cerca de 0,6s depois que o logo aparecer, para que a URL fique na tela por 3s ou mais.
- Mantenha cada comprimento de segmento um múltiplo da batida (0,5s a 120 BPM) para que todos os cortes caiam nas batidas, e passe
--droppara que o drop atinja o primeiro corte. - O primeiro quadro de um reel já deve mostrar o gancho. Não há tempo para um fade-in lento.
Após a renderização, extraia um quadro do meio e do final de cada segmento no MP4 finalizado e observe-os. Em seguida, diga ao usuário qual reel postar primeiro (aquele que abre com um problema), quais são apenas para públicos engajados (puramente estéticos, sem dor) e que letras miúdas não serão legíveis nesse ritmo, então o gancho também deve ir na legenda do post.
10. Entrega
Envie os MP4(s) para o usuário como arquivos. Em seguida, faça uma crítica honesta: duração total (80s é longo; 30–45s serve para Reels/Shorts), a cena mais fraca e um corte ou reordenação concreto. Ofereça os próximos passos: corte vertical, reels de 15s, música, cortes. Não faça commit de arquivos de vídeo ou fontes de build no repositório do produto, a menos que solicitado.
Checklist de entrega
- Cada número/nome na tela corresponde à saída real do produto
- Nada que o usuário pediu para deixar de fora aparece em lugar nenhum
- Nenhum texto
[placeholder]deixado, nenhum elemento cortado ou sobreposto em qualquer quadro pré-visualizado - O número do gancho conta nos primeiros 5s; a URL fica na tela por pelo menos 3s no final
- Transições verificadas no MP4 codificado, não apenas nas imagens estáticas
- Música (se houver) está cortada, com fade out, normalizada e seu drop cai em um corte de cena
- Cada clique do cursor atinge um elemento já visível e causa algo
- Cliques, teclas e ticks são audíveis sobre a música (verifique a banda >2,5 kHz), e a mixagem final está a -16 LUFS
- Reels: cada segmento termina após sua recompensa (sem contadores incompletos), a URL aparece por 3s ou mais, cortes caem nas batidas