Communitygithub.com

diorama-promo-video

Crie vídeos verticais curtos (9:16) no estilo 'diorama em miniatura' para Instagram Reels, TikTok e YouTube Shorts — com blocos de argila, banners de papel, legenda palavra por palavra e grain — tudo renderizado com Remotion a partir de um simples JSON.

O que é diorama-promo-video?

Este skill gera vídeos promocionais verticais de 30 a 50 segundos no formato 9:16 (1080×1920, 30 fps) no estilo 'diorama em miniatura', inspirado no viral '5 Claudes roast your LinkedIn'. Ele monta um pequeno palco com personagens de blocos de argila que encenam o produto em cenas, enquanto legendas aparecem palavra por palavra em tiras de papel rasgado, com um banner de manchete de papel adesivo, um placar de contagem, grão de filme e uma chamada para ação 'comente LINK'. Tudo é controlado por um único arquivo JSON (`src/video.json`) dentro de um projeto Remotion pré-configurado. É ideal quando o usuário pede vídeos para Reels, TikTok, YouTube Shorts, vídeos promocionais de ferramentas de IA, prompts, templates ou produtos digitais, ou quando deseja 'refazer' um vídeo existente nesse estilo. O fluxo de trabalho inclui: escrever um roteiro em tabela com 9–12 cenas, construir o projeto via script, gerar uma folha de pré-visualização para ajustes rápidos, sincronizar narração via `faster-whisper`, renderizar e entregar o MP4. Suporta restilização automática extraindo áudio e legendas de vídeos existentes.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/uhandani/Skill-video-nocodealex/tree/HEAD/diorama-promo-video

Perguntar na sua IA favorita

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

Documentação

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 em theme.

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:

  1. 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 um overview.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.
  2. 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.
  3. 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-after com rewrite:false + stamp ("MITO", "FAKE"), spotlight (uma pessoa/revelação) e cta para o fechamento com prompt de comentário.
  4. Escreva video.json com "voiceover" e uma array "captions" de {word,start,end} (segundos absolutos, em ordem). O text de 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ém start 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.
  5. 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, theme e characters em video.json. Em mono tudo é forçado para escala de cinza, então a cor personalizada de theme importa 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.

Habilidades Relacionadas