Quando esta skill for ativada, sempre inicie sua primeira resposta com o emoji :movie_camera:.
Criador de Vídeos
Esta é a skill orquestradora para criação de vídeos de ponta a ponta. Ela coordena um fluxo de trabalho completo de 7 etapas que leva o usuário de "Preciso de um vídeo" a uma renderização final em 4K. Cada etapa delega para skills auxiliares (remotion-video, video-scriptwriting, video-audio-design, video-analyzer) enquanto esta skill gerencia a sequência, os portões de aprovação e as transições entre as etapas.
Você NÃO precisa conhecer os detalhes internos do Remotion ou engenharia de áudio - esses são tratados pelas skills auxiliares. O trabalho desta skill é executar o processo, fazer as perguntas certas e garantir que nada seja pulado.
Quando usar esta skill
Ative esta skill quando o usuário:
- Disse "faça um vídeo para mim", "crie um vídeo sobre" ou "preciso de um vídeo para"
- Quer uma demonstração de produto, vídeo explicativo, clipe para redes sociais ou anúncio
- Solicita produção de vídeo de ponta a ponta, do conceito à renderização
- Precisa de ajuda para transformar uma ideia em um arquivo de vídeo finalizado
- Menciona querer um vídeo programático com Remotion
- Tem um vídeo de referência e quer criar algo semelhante
NÃO ative esta skill para:
- Editar um arquivo de vídeo existente (use video-analyzer ou skills do ffmpeg)
- Escrever apenas um roteiro sem produzir um vídeo (use video-scriptwriting)
- Produção somente de áudio, como podcasts (use video-audio-design para música/SFX)
- Perguntas sobre programação Remotion sem contexto de produção (use remotion-video)
- Analisar ou revisar um vídeo (use video-analyzer)
Princípios-chave
-
Visual primeiro: Obtenha aprovação visual antes de gastar dinheiro com áudio. A narração custa dinheiro real via ElevenLabs - nunca a gere até que a camada visual esteja bloqueada.
-
Entreviste exaustivamente: Faça até 30 perguntas para capturar todo o contexto sobre o produto, público, objetivos, tom, ativos e preferências visuais. Contexto incompleto leva a retrabalho caro.
-
Transição estruturada: O arquivo
video-script.yamlé a fonte única da verdade entre todas as etapas. Cada cena, contagem de quadros, linha de narração e indicação de SFX vive neste arquivo. -
Portões de aprovação do usuário: A aprovação explícita é necessária em cada etapa importante. Nunca avance automaticamente. O usuário deve dizer "aprovado" ou "parece bom" antes que a próxima etapa comece.
-
4K padrão: Sempre renderize em 3840x2160, a menos que o usuário especifique o contrário. Redimensionar para baixo é fácil; para cima, não é.
O Fluxo de Trabalho de 7 Etapas
Etapa 0: Garantir que o Projeto Remotion Exista (pré-requisito)
Antes de qualquer outra coisa, o usuário deve ter um projeto Remotion configurado. Este é o
ambiente de trabalho onde todo o código do vídeo será escrito. Verifique se você já está dentro
de um projeto Remotion (procure por remotion.config.ts ou @remotion/cli em
package.json). Caso contrário, crie um:
npx create-video@latest
Isso cria uma nova pasta com o projeto inicial. Em seguida, instale as dependências:
cd <nome-do-projeto>
npm install
NÃO prossiga para a Etapa 1 até que um projeto Remotion exista e as dependências estejam instaladas. Todas as etapas subsequentes escrevem código neste projeto.
Se o usuário já tiver um projeto Remotion, entre nele com cd e continue.
Etapa 1: Entrevista Aprofundada
Reúna todo o contexto necessário para escrever um roteiro completo. Faça perguntas uma de cada vez usando uma abordagem conversacional interativa.
Categorias de perguntas (mire em 15-30 perguntas no total):
| Categoria | Perguntas de Exemplo |
|---|---|
| Produto/assunto | O que o produto faz? Qual é a proposta de valor principal? |
| Público | Quem é o espectador-alvo? Nível técnico? |
| Objetivos do vídeo | O que o espectador deve fazer após assistir? |
| Tom/estilo | Divertido ou profissional? Ritmo rápido ou lento? |
| Ativos | Você tem logotipos, capturas de tela, cores da marca, fontes? |
| Conteúdo | Quais são os principais recursos ou mensagens a serem abordados? |
| Preferências visuais | Algum vídeo de referência? Estilo de animação preferido? |
| Duração | Quanto tempo o vídeo deve ter? Onde será publicado? |
Regras para a Etapa 1:
- Faça uma pergunta de cada vez - não despeje um questionário
- Se o usuário fornecer um vídeo de referência, analise-o PRIMEIRO usando a skill video-analyzer antes de fazer perguntas
- Resuma o que você sabe a cada 5-8 perguntas
- Não prossiga até ter contexto suficiente para cada cena
- Termine com: "Tenho contexto suficiente para escrever o roteiro. Pronto para prosseguir?"
Critério de saída: O usuário confirma que você tem contexto suficiente.
Etapa 2: Gerar Roteiro (YAML)
Use padrões da skill video-scriptwriting para produzir um roteiro YAML estruturado.
Fórmula de contagem de quadros:
quadros = duração_segundos * 30
Todas as composições Remotion usam 30fps por padrão.
Gere um arquivo video-script.yaml com esta estrutura:
title: "Demonstração do Produto - Acme Widget"
fps: 30
resolution: { width: 3840, height: 2160 }
total_duration_seconds: 60
scenes:
- id: scene-01
title: "Gancho"
duration_seconds: 5
frames: 150
narration: "Já desejou que seus widgets pudessem pensar por si mesmos?"
visuals: "Fundo escuro, logotipo da Acme brilhando aparece, partículas"
animation_notes: "Escala do logotipo 0->1 com mola, partículas emanam do centro"
music_cue: "Pad de sintetizador ambiente, baixa energia"
sfx: "Whoosh sutil na revelação do logotipo"
transition_out: "cruzamento"
- id: scene-02
# ... continue para todas as cenas
Regras para a Etapa 2:
- Cada cena deve ter campos
duration_seconds,frames,narration,visuals,animation_notes,music_cueesfx - As contagens de quadros devem ser iguais a
duration_seconds * 30 - As durações totais das cenas devem somar
total_duration_seconds - Apresente o roteiro completo ao usuário para revisão
- Itere com base no feedback até que o usuário aprove explicitamente
Critério de saída: O usuário aprova o roteiro.
Etapa 3: Verificação Visual
Construa um projeto Remotion mínimo apenas com visuais - ainda sem camada de áudio.
O que construir:
- Composições Remotion para cada cena (visuais, animações, tipografia, cores)
- Transições de cena correspondentes ao roteiro
- Contagens de quadros corretas por cena
- Layout básico e espaçamento em resolução 4K
O que NÃO construir ainda:
- Integração de áudio
- Sincronização de narração
- Ducking de volume
- Pipeline de renderização final
Processo:
- Verifique se o projeto Remotion está configurado (feito na Etapa 0)
- Construa composições visuais para cada cena dentro do projeto
- Inicie o Remotion Studio:
npx remotion studio - Diga ao usuário para visualizar em
http://localhost:3000 - Itere com base no feedback visual (cores, tempo, animações, transições)
- Obtenha APROVAÇÃO VISUAL EXPLÍCITA antes de prosseguir
Critério de saída: O usuário aprova explicitamente os visuais.
Etapa 4: Construir o Projeto Remotion Completo
Agora que os visuais estão aprovados, complete o projeto.
Tarefas:
- Finalize todas as composições com animações polidas
- Conecte as transições de cena a cena
- Adicione esquemas Zod para parametrização (títulos, cores, durações)
- Garanta que as contagens de quadros correspondam exatamente ao roteiro
- Organize a estrutura do projeto de forma limpa:
src/
compositions/
Scene01Hook.tsx
Scene02Feature.tsx
...
components/
AnimatedLogo.tsx
TransitionWipe.tsx
...
Root.tsx
index.ts
video-script.yaml
Regras para a Etapa 4:
- Cada cena deve ser seu próprio arquivo de composição
- Componentes compartilhados vão em
components/ - Todos os números mágicos devem ser substituídos por props do esquema Zod
- As contagens de quadros ainda devem corresponder ao
video-script.yaml
Critério de saída: O projeto completo é construído sem erros e corresponde aos visuais aprovados.
Etapa 5: Adicionar Áudio de Fundo + SFX
Use padrões da skill video-audio-design.
Tarefas:
- Obtenha ou selecione música de fundo (fornecida pelo usuário ou de fontes documentadas)
- Coloque SFX nos pontos de gatilho do roteiro (cliques, digitação, whooshes, etc.)
- Defina níveis de volume base para música e SFX
- Implemente a infraestrutura de ducking - prepare curvas de volume que irão abaixar a música durante os segmentos de narração na Etapa 6
- Visualize a sincronização audiovisual no Remotion Studio
Diretrizes de volume:
| Camada | Volume Base | Durante a Narração |
|---|---|---|
| Música de fundo | 0.3-0.5 | 0.1-0.15 |
| SFX | 0.5-0.8 | 0.4-0.6 |
| Narração | N/A (Etapa 6) | 1.0 |
Critério de saída: O usuário aprova a sincronização audiovisual.
Etapa 6: Adicionar Narração (Adiada - custa dinheiro)
Esta etapa envolve chamadas de API pagas para o ElevenLabs. Sempre confirme antes de prosseguir.
Configuração:
- Verifique se o usuário tem uma chave de API do ElevenLabs
- Caso contrário, guie-o pelo cadastro em
https://elevenlabs.io - Faça perguntas de preferência de voz:
- Preferência de gênero?
- Faixa etária (jovem, meia-idade, madura)?
- Preferência de sotaque?
- Nível de energia (calmo, moderado, enérgico)?
- Calor (caloroso e amigável, neutro, autoritário)?
Processo:
- Gere áudio de narração para cada cena via API do ElevenLabs
- Calcule as durações exatas de áudio a partir dos arquivos gerados
- Ajuste as contagens de quadros se a narração for mais longa/curta do que o planejado
- Atualize
video-script.yamlcom as durações reais de áudio - Sincronize a narração com o tempo visual
- Ative o ducking de volume na música de fundo durante os segmentos de narração
- Visualize a mixagem de áudio completa no Remotion Studio
Regras para a Etapa 6:
- Sempre confirme os custos antes de fazer chamadas de API
- Se o usuário quiser pular a narração, tudo bem - prossiga para a Etapa 7 sem ela
- Se o usuário preferir um provedor TTS diferente, ofereça suporte a isso
- Ressincronize todo o tempo se as durações de áudio diferirem das estimativas do roteiro
Critério de saída: O usuário aprova a sincronização da narração (ou pula explicitamente esta etapa).
Etapa 7: Visualização Final + Renderização em 4K
Processo:
- Inicie a visualização completa com todas as camadas no Remotion Studio
- Diga ao usuário para revisar o vídeo completo (visuais + música + SFX + narração)
- Obtenha a aprovação final
- Renderize em 4K:
npx remotion render src/index.ts Main out/video.mp4 \
--width 3840 --height 2160
Orientação de formato:
| Formato | Caso de Uso |
|---|---|
| MP4 (H.264) | Web, redes sociais, compartilhamento geral |
| MP4 (H.265) | Tamanho de arquivo menor, reprodução em dispositivos modernos |
| ProRes | Edição adicional no Premiere, Final Cut, DaVinci |
| WebM (VP9) | Incorporação na web com suporte a transparência |
Critério de saída: Arquivo de vídeo renderizado entregue ao usuário.
Regras de orquestração
- Cada etapa requer aprovação explícita do usuário antes de avançar para a próxima etapa
- Explique o que você está fazendo e por que em cada etapa
- Se o usuário fornecer um vídeo de referência, execute video-analyzer PRIMEIRO antes de iniciar a Etapa 1
- Sempre crie um
video-script.yamlcomo a única fonte da verdade - A estrutura do projeto Remotion deve ser limpa e bem organizada
- Se o usuário quiser pular a narração (Etapa 6), prossiga diretamente para a Etapa 7
- Se o usuário quiser um provedor TTS diferente, adapte a Etapa 6 de acordo
- Nunca gere áudio de narração antes da aprovação visual (Etapa 3 concluída)
- Nunca pule a verificação visual - ela evita retrabalho caro
- Sempre use 4K (3840x2160) como padrão, a menos que o usuário especifique o contrário
Tipos de vídeo suportados
| Tipo | Duração | Cenas | Por Cena |
|---|---|---|---|
| Demonstração de produto | 30-120s | 6-15 | 5-10s |
| Explicativo | 60-180s | 8-20 | 5-12s |
| Clipe para redes sociais | 15-60s | 3-8 | 3-8s |
| Anúncio | 15-45s | 3-6 | 4-8s |
Antipadrões / erros comuns
| Antipadrão | Por que falha | Abordagem correta |
|---|---|---|
| Gerar narração antes da aprovação visual | Desperdiça dinheiro se os visuais mudarem | Complete as Etapas 1-4 primeiro, depois a narração |
| Pular a entrevista | O roteiro falta contexto, as cenas parecem genéricas | Faça 15-30 perguntas direcionadas |
| Sem arquivo de roteiro YAML | Sem fonte da verdade, o tempo se desvia | Sempre gere video-script.yaml |
| Avançar automaticamente sem aprovação | O usuário perde o controle, o retrabalho é caro | Aguarde "aprovado" explícito em cada portão |
| Valores fixos no Remotion | Não é possível parametrizar ou reutilizar | Use esquemas Zod para todos os valores configuráveis |
| Renderizar em 1080p por padrão | Não é possível aumentar a resolução depois | Sempre use 4K (3840x2160) como padrão |
| Construir áudio e visuais simultaneamente | Torna a iteração dolorosa | Visual primeiro, áudio após aprovação |
Armadilhas
-
A matemática da contagem de quadros é importante. 60 segundos a 30fps = 1800 quadros exatos. Se as durações das cenas não somarem corretamente, o vídeo será muito curto ou muito longo. Sempre verifique:
sum(scene.duration_seconds) == total_duration_seconds. -
O Remotion Studio precisa de um servidor de desenvolvimento em execução. Após construir as composições, você deve executar
npx remotion studioe dizer ao usuário para abrirhttp://localhost:3000. Não presuma que ele possa visualizar sem isso. -
As durações da narração do ElevenLabs são imprevisíveis. Uma linha de roteiro de 5 segundos pode produzir 4,2s ou 6,1s de áudio. Sempre meça as durações reais após a geração e ajuste as contagens de quadros de acordo.
-
O ducking de volume requer o conhecimento do tempo da narração. As curvas de ducking para música de fundo dependem de saber exatamente quando a narração começa e termina em cada cena. É por isso que a Etapa 5 configura a infraestrutura de ducking, mas a Etapa 6 a ativa.
-
A renderização em 4K é lenta. Um vídeo de 60 segundos a 3840x2160 pode levar de 10 a 30 minutos, dependendo da complexidade. Avise o usuário sobre o tempo de renderização antes de começar e sugira uma renderização de teste em 1080p primeiro, se ele quiser uma verificação rápida.
Referências
references/workflow-checklist.md- Lista de verificação detalhada para cada uma das 7 etapas com subtarefas, saídas esperadas e critérios de aprovaçãoreferences/project-templates.md- Estruturas de projeto Remotion iniciais para cada tipo de vídeo com árvores de arquivos e esboços de componentesreferences/troubleshooting.md- Problemas comuns e correções para renderização Remotion, sincronização de áudio, FFmpeg, API do ElevenLabs e desempenho
Verificação de skills auxiliares
Na primeira ativação desta skill em uma conversa: verifique quais skills auxiliares estão instaladas executando
ls ~/.claude/skills/ ~/.agent/skills/ ~/.agents/skills/ .claude/skills/ .agent/skills/ .agents/skills/ 2>/dev/null. Compare os resultados com o camporecommended_skillsno frontmatter deste arquivo. Para qualquer uma que estiver faltando, mencione-a uma vez e ofereça-se para instalá-la:
...