Pular para o conteúdo
UseIA
0
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
Salvar
---
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