Skill
Remotion Motion Graphics - Claude
Crédito: haidrrrry no GitHub (haidrrrry/claude-remotion-skill) · 0 cópias
Indicada na UseIA por Cristiano Rochenbach Abreu em 4 de out. de 2026
255 estrelas no GitHubVer no GitHub
Conteúdo
---
name: remotion-motion-graphics
description: Criar e editar vídeos profissionais de motion graphics com Remotion (vídeo baseado em React). Use esta skill SEMPRE que o usuário quiser criar um vídeo, editar um vídeo, animar algo, criar uma animação de introdução/final/logo, produzir um Reel/Short/vídeo promocional/de lançamento, adicionar animações de texto ou legendas a uma gravação, combinar imagens e B-roll em um vídeo, ou mencionar Remotion, motion graphics, renderização de vídeo ou "deixar este vídeo melhor/menos genérico". Também deve ser acionada ao editar um projeto Remotion existente ou quando o usuário reclamar que o vídeo parece básico, genérico ou amador — esta skill contém as correções exatas. Sempre leia esta skill ANTES de escrever qualquer código Remotion.
---
# Remotion Motion Graphics
O Remotion renderiza componentes React quadro a quadro para gerar vídeos. A qualidade do código não é o principal gargalo — **o domínio de motion design é**. Gerações sem conhecimento especializado tendem a produzir easing linear, transições baseadas apenas em opacidade, entradas simultâneas, cores chapadas e ausência de textura. Esse é o visual de "vídeo genérico de IA". Esta skill existe para evitar isso.
## Regras não negociáveis (aplicam-se a TODA composição)
1. **NUNCA use interpolação linear.** Todo `interpolate()` deve receber uma curva de easing; toda entrada deve preferencialmente usar `spring()`. Sempre use `extrapolateLeft/Right: "clamp"`.
2. **As entradas devem animar 2–3 propriedades juntas** (opacidade + translateY + scale). Um simples fade é proibido.
3. **Crie stagger em tudo.** Listas, palavras, raios, cards: use deslocamentos de 3–6 frames. Nada deve entrar simultaneamente.
4. **As saídas devem existir e ser mais rápidas que as entradas** (~10 frames contra ~20).
5. **Use uma estrutura de cinco camadas em toda cena**, de baixo para cima: background mesh → assets → gráficos/tipografia → color grade → grain + vignette. Nunca use um fundo sólido e plano.
6. **Toda imagem estática deve receber Ken Burns** (escala lenta de 1→1.08 + deslocamento/pan). Todo asset de vídeo deve usar `<OffthreadVideo>`, nunca `<Video>`.
7. **Elementos em estado ocioso devem "respirar"**: qualquer elemento que permaneça na tela por mais de 2s deve receber microanimação baseada em onda senoidal.
8. **Todo timing deve derivar de `fps`** usando `useVideoConfig()`. Não use números de frames arbitrários ("magic numbers").
9. **Tenha um único objeto de tema no topo do projeto** (cores, easings, presets de spring, fontes). Nunca coloque uma cor hexadecimal ou easing diretamente dentro de um componente.
10. **Renderize, extraia frames, OLHE para eles, corrija e renderize novamente.** Nunca entregue um render sem verificar. Esse ciclo é obrigatório — veja a seção de Verificação abaixo.
## Fluxo de trabalho
### Etapa 1 — Escopo
Determine: duração, fps (30 por padrão; 60 somente para movimentos rápidos e intensos), dimensões (1080×1920 para Reels/Shorts, 1920×1080 para vídeos horizontais), quais assets existem (imagens, vídeos, áudio, logos) e se esta é uma nova composição ou uma edição de um projeto existente.
Se estiver editando um projeto existente: leia `src/` completamente primeiro, encontre o tema (ou crie um) e corrija violações das regras acima antes de adicionar novas funcionalidades.
### Etapa 2 — Configuração
Novo projeto:
```bash
npm install remotion @remotion/cli react react-dom
# opcional: @remotion/transitions @remotion/motion-blur @remotion/google-fonts
```
Copie `assets/theme.ts` desta skill para `src/theme.ts` e ajuste a paleta para a identidade visual do usuário.
Estrutura:
`src/index.ts` (registerRoot) → `src/Root.tsx` (Composition, duração/fps/tamanho) → `src/scenes/*.tsx` → `src/components/*.tsx`.
Os assets do usuário devem ficar em `public/`, carregados usando `staticFile()`.
### Etapa 3 — Construção
Leia `references/motion-patterns.md` para conhecer as implementações reutilizáveis dos componentes:
- BgMesh
- Grade
- Grain
- Vignette
- KenBurns
- WordReveal
- Stagger
- Counter
- Spark
- Transitions
- Parallax
Monte as cenas a partir desses padrões.
Para regras de ritmo, tipografia, paletas de cores e design de som, leia `references/design-rules.md`.
**Ritmo da cena:** HIT → hold (15–20 frames estáticos) → build → HIT.
Algo deve se mover nos primeiros 15 frames.
Nunca passe de 90 frames sem introduzir um novo elemento visual.
### Etapa 4 — Renderização
```bash
npx remotion render src/index.ts <CompId> out/video.mp4 --codec h264 --crf 17
```
O Remotion precisa de um binário do Chromium. Se o download automático falhar (sandboxes, CI offline), encontre um e passe o caminho explicitamente:
```bash
which chromium chromium-browser google-chrome 2>/dev/null
ls /opt/pw-browsers 2>/dev/null # instalações do Playwright ficam aqui
npx remotion render ... --browser-executable=<path>
```
Se o Chrome completo apresentar o erro `"Old Headless mode has been removed"`, use um binário `headless_shell` em seu lugar. O Playwright inclui um em:
`chromium_headless_shell-*/chrome-linux/headless_shell`
### Etapa 5 — VERIFICAÇÃO (obrigatória, nunca pule)
Extraia frames em momentos importantes e faça uma inspeção visual de cada um.
O método portátil — funciona em máquinas sem ffmpeg instalado no sistema e renderiza exatamente o frame desejado:
```bash
for f in 15 45 90 150; do
npx remotion still src/index.ts <CompId> out/check_$f.png --frame $f --overwrite
done
```
Se o ffmpeg do sistema estiver disponível, extrair os frames do MP4 final também verifica o próprio encode (`-ss` é mais portátil do que filtros `select=`, cuja forma de escaping pode quebrar em alguns shells e no ffmpeg incluído no Remotion):
```bash
ffmpeg -v error -ss 1.5 -i out/video.mp4 -frames:v 1 check_1.png
```
Verifique e corrija, na ordem de frequência:
- **Problemas de espaçamento:** `gap`/`margin` em `em` é calculado com base no `font-size` do elemento PAI (frequentemente 16px), e não no tamanho do texto. Use valores em px em containers flex que envolvam tipografia grande.
- Textos ultrapassando os limites ou encostando nas bordas do frame. Para vídeos 9:16, mantenha o conteúdo crítico nos 75% centrais verticalmente, pois a interface das plataformas cobre as partes superior e inferior.
- Elementos visíveis antes da entrada ou depois da saída (ausência de `clamp`).
- Falhas de cor/contraste: não use a cor principal em mais de 1 elemento por frame; textos escuros podem ficar ilegíveis sobre o color grade.
- Erros na ordem das camadas (grain/vignette devem estar no topo; o grade deve ficar acima do conteúdo).
**Corrija → renderize novamente → extraia novamente → inspecione novamente.**
Somente entregue depois de uma verificação limpa.
Depois, execute o checklist final no final de `references/design-rules.md`.
### Edição de uma gravação existente do usuário
Para aprimorar um MP4 existente (legendas, color grade, introdução/final) em vez de criar tudo do zero:
Coloque o arquivo em `public/` e renderize-o como a camada de asset usando:
```tsx
<OffthreadVideo src={staticFile("clip.mp4")} />
```
Defina a duração da composição com base na duração do clipe e coloque gráficos/grade/grain acima dele.
Obtenha a duração e o fps do clipe usando `ffprobe` antes de configurar a composição.
Para legendas sincronizadas palavra por palavra sobre fala, consulte a seção de captions em `references/motion-patterns.md`.
## Arquivos de referência
- `references/motion-patterns.md` — biblioteca de componentes pronta para copiar e colar: backgrounds, grade/grain/vignette, Ken Burns, revelação de texto, contadores, transições, parallax, sincronização de áudio e legendas. Leia antes de escrever componentes.
- `references/design-rules.md` — paletas, regras de tipografia, arquitetura de cenas, design de som e checklist de pré-entrega. Leia antes de criar cenas e antes da entrega final.
- `assets/theme.ts` — modelo de tema para copiar para cada projeto.
## Principais falhas que devem ser evitadas ativamente
- **Usar emoji como ícones.** Emojis são renderizados como glifos coloridos da plataforma (✳️ verde, 🌐 azul), ignoram sua paleta, quebram silenciosamente a regra de uma única cor principal e ficam sobre qualquer background definido (mascote laranja sobre um bloco laranja = invisível). Desenhe os glifos usando CSS/SVG nas cores do tema ou verifique cada emoji nos frames extraídos.
- **A ausência de assets de SFX não é motivo para entregar um vídeo sem som.** Sintetize um kit mínimo de efeitos em WAV de 16 bits usando um script Node (whoosh de burst de ruído, pop com queda de pitch, kick/bass com thump senoidal, pad com seno desafinado) dentro de `public/sfx/`. Consulte `examples/scripts/` no repositório. Zero downloads e totalmente determinístico.
- Criar um único componente gigante em vez de componentes temáticos e reutilizáveis.
- Incompatibilidade de `durationInFrames` entre a Composition e o conteúdo da cena (espaços vazios/tempo morto).
- Esquecer `--overwrite` ao renderizar novamente e acabar inspecionando um arquivo antigo.
- **Fontes:** nunca dependa das fontes padrão do sistema para textos principais. Carregue uma fonte de destaque usando `@remotion/google-fonts` ou `@font-face` + `staticFile`.
- Tentar "descrever" o resultado para o usuário em vez de renderizar e verificar o resultado.Funciona com:Claude

