Vídeo promocional diorama
Produz um vídeo vertical de ~30–50 s (1080×1920, 30 fps) no estilo do viral
"5 Claudes roast your LinkedIn": um palco com personagens de blocos que
encenam o que um produto faz, cena por cena, enquanto as legendas aparecem
palavra por palavra. Tudo é controlado por um arquivo, src/video.json, em um
projeto Remotion construído a partir de assets/template/.
Leia references/style-guide.md para entender por que o formato funciona
(ritmo, tipografia, arco narrativo) e references/scene-types.md para todos os
campos JSON.
Fluxo de trabalho
1. Obter o briefing (pergunte apenas o que estiver faltando)
- O que está sendo promovido e as coisas concretas que ele faz (saídas, números, etapas).
- Palavra-chave CTA que as pessoas comentam (padrão
LINK) e se é gratuito. - Idioma da narração/legendas — corresponda ao usuário (solicitação em português → roteiro em português, a menos que ele diga o contrário). Banners podem permanecer em inglês se o usuário preferir o "visual IG".
- Narração: eles têm uma gravação? Se não, o vídeo funciona apenas com legendas; ofereça-se para escrever um roteiro que eles possam gravar e sincronizar depois (etapa 5).
- O "acessório" na mesa (perfil, site, currículo, loja…) — existem padrões sensíveis.
- Paleta: monocromática em escala de cinza é o padrão (
"palette": "mono"). Use"warm"apenas se o usuário pedir cor; tokens individuais podem ser sobrescritos emtheme.
2. Escreva o roteiro primeiro, como uma tabela
Siga o arco do guia de estilo: gancho → mecanismo → dor → saídas → transformação →
recompensa → prova → gratuito → fácil → CTA. 9 a 12 cenas, uma frase cada, ~2,7 palavras/s
para que uma cena dure 2,5–4,5 s. Para cada cena, escolha um tipo de cena que mostre a
frase (uma frase sobre "cinco opiniões" → lineup com cinco placas e um contador automático).
Mostre a tabela (banner | narração | tipo de cena) para o usuário e ajuste antes de construir —
alterar a tabela é barato, re-renderizar não.
3. Construir o projeto
bash <skill-dir>/scripts/new_video.sh <project-dir> # copia o template + npm install
Em seguida, escreva <project-dir>/src/video.json a partir do roteiro aprovado. Comece pelo
exemplo já existente nesse arquivo (ele recria o vídeo de referência) — mantenha sua estrutura.
Limites práticos que mantêm os layouts limpos: banner ≤ 30 caracteres, placas 1–2 palavras,
linhas do card ≤ ~25 caracteres e ≤ 7 linhas, list ≤ 4 itens, ≤ 5 caracteres em hero.
4. Verifique visualmente antes da renderização completa
node <skill-dir>/scripts/preview_sheet.mjs <project-dir> # → out/sheet.jpg, um quadro por cena
Observe a folha (leia a imagem). Verifique: banner não cortado, legendas não cobrem o
acessório principal, contadores mostram os números corretos, nada transborda do card.
Corrija video.json e execute novamente. Isso leva segundos; uma renderização completa
leva minutos.
5. Sincronização da narração (quando houver áudio)
Coloque o áudio em <project-dir>/public/ e execute:
pip install faster-whisper # uma vez, se estiver faltando
python3 <skill-dir>/scripts/word_timings.py <project-dir> voiceover.mp3 --lang pt
Isso escreve os tempos das palavras em video.json (captions, voiceover); os cortes de
cena então caem exatamente onde cada frase começa. Música de fundo: coloque em public/ e
defina "music": "file.mp3" (volume padrão 0.12). Sem áudio, os tempos são estimados a
partir do texto.
6. Renderizar e entregar
bash <skill-dir>/scripts/render.sh <project-dir> out/video.mp4
render.sh usa um Chrome/Chromium local como fallback quando o Remotion não consegue baixar
o próprio navegador (comum em sandboxes). Um vídeo de 45 s leva alguns minutos. Entregue o
MP4 e também escreva a legenda da postagem no padrão de referência:
Comente "LINK" e eu envio o link para você no DM… Comente "LINK" para o link. #…
Para ajustes ao vivo, o usuário pode executar npx remotion studio dentro do projeto.
Restilização de um vídeo existente
Quando o usuário fornecer um vídeo e pedir "neste estilo", mantenha a história e a voz dele e substitua apenas os visuais:
bash <skill-dir>/scripts/caption_strips.sh <video> <work-dir>— extrai o áudio (voiceover.m4a) e gera tiras da faixa de legendas a cada 0,5 s com timestamps, além de umoverview.jpg. Se o whisper funcionar,word_timings.pyé mais rápido; quando não funciona (sem download do modelo), leia as tiras: a palavra destacada em cada tira é aquela sendo falada naquele timestamp, o que fornece os tempos das palavras com ±0,25 s. Verifique a posição da faixa em um quadro de prova primeiro — um corte errado mostra apenas fragmentos de texto.- Divida a transcrição em batidas onde o vídeo original muda de visuais ou tópico (a visão geral mostra isso). Uma batida = uma cena, 3–8 s.
- Escolha um tipo de cena que mostre cada batida. Explicadores usam
board(símbolos, "A → B", riscar respostas erradas),timeline(datas, pessoas),card(definições, citações, termos destacados),before-aftercomrewrite:false+stamp("MITO", "FAKE"),spotlight(uma pessoa/revelação) ectapara o fechamento com prompt de comentário. - Escreva
video.jsoncom"voiceover"e uma array"captions"de{word,start,end}(segundos absolutos, em ordem). Otextde cada cena deve conter exatamente as palavras daquela cena em ordem — as cenas são temporizadas a partir de onde a primeira palavra começa. Um pequeno script Python que mantémstart word|start word|…por cena e emite ambos é a forma menos propensa a erros.assets/examples/restyle_asal_usul_x.pyé um exemplo completo (um vídeo explicativo indonésio de 90 s sobre por que a álgebra usa x, 16 cenas) — copie sua estrutura. - Folha de pré-visualização → corrigir → renderizar como de costume. Os banners podem estar no idioma do vídeo.
Personalizando além do JSON
- Cores/elenco:
palette,themeecharactersemvideo.json. Emmonotudo é forçado para escala de cinza, então a cor personalizada dethemeimporta apenas por sua luminosidade. - Novo ritmo visual: adicione um tipo de cena (passos no final de
references/scene-types.md). - Anime apenas com
useCurrentFrame()+interpolate/spring; transições/animações CSS não renderizam no Remotion. Mantenha y 1440–1620 livre para legendas.
Originalidade
Os mascotes, cenários e adereços do template são genéricos e originais. Mantenha assim: não copie personagens, logotipos ou filmagens de outro criador para o vídeo; nomes de marcas reais podem aparecer como texto (ex.: "LinkedIn") ao descrever com o que o produto funciona.