Reel Educativo IA — do roteiro ao MP4
Esta skill produz um reel vertical curto (≤ 60 s, 1080×1920) com finalidade pedagógica, 100% gerado com IA e código: o usuário fornece um roteiro (ou uma ideia que se converte em roteiro), e o pipeline entrega um reel.mp4 com narração, legendas sincronizadas, elementos visuais e balões com emojis que reforçam os conceitos.
O princípio é o mesmo de Ágora: ao finalizar o reel, a pessoa deve compreender algo melhor do que antes. O formato curto não é desculpa para trivializar; é um exercício de destilar uma ideia ao seu núcleo.
O que produz
Um vídeo vertical onde convivem quatro camadas:
- Narração (ElevenLabs) — narra o roteiro.
- Legendas sincronizadas palavra por palavra (estilo karaokê), legíveis no modo mudo, que é como a maioria dos reels é consumida.
- Representação visual — fundo com motion graphics gerados por código e/ou imagens/clipes (de IA ou stock) que ilustram a cena.
- Balões, emojis e referências — etiquetas animadas que nomeiam o conceito (⚖️ "Separação de poderes"), emojis flutuantes de apoio e referências de fonte (📜 "Art. 113 C.P.") sobre o conteúdo do qual se fala.
O pipeline em uma frase
Roteiro → storyboard.json (você faz, Claude) → voz + sincronia (ElevenLabs) → render (Remotion) → reel.mp4.
Nos comandos abaixo,
$SKILL_DIRé a pasta desta skill (~/.claude/skills/reel-educativo-ia). Substitua pelo caminho real ao executar.
Fluxo de trabalho
0. Preflight — ferramentas (uma única vez por máquina)
O render precisa de Node.js e FFmpeg (que traz ffprobe). Verifique e instale o que faltar antes de montar qualquer coisa:
bash "$SKILL_DIR/scripts/preflight.sh"
O que faz: verifica node, ffmpeg/ffprobe e python3. Se faltar Node ou FFmpeg e houver Homebrew, os instala (brew install node ffmpeg).
A voz NÃO exige que o usuário lide com uma chave de API. Existem dois caminhos (veja o passo 4): o recomendado usa o MCP do ElevenLabs (a chave fica na configuração do MCP, você não a toca) com uma voz pré-fabricada de uso livre. Se algum dia usar o caminho direto pela API, a chave só fica em ELEVENLABS_API_KEY e nunca é escrita no storyboard, no repositório nem em uma mensagem.
1. Entenda a solicitação (pergunte apenas o essencial que faltar)
Você precisa de cinco coisas; se o usuário já as forneceu, não interrogue:
- Roteiro — o texto a ser narrado. Se houver apenas uma ideia, escreva você (veja passo 2) e confirme antes de produzir.
- Contexto — a quem se destina, de qual projeto/campanha, qual tom.
- Objetivo pedagógico — o que quem assistir deve compreender.
- Plataforma — Reels / TikTok / Shorts (o formato 9:16 serve para as três; só mudam detalhes de duração e texto de encerramento).
- Voz — uma voz pré-fabricada de uso livre (p. ex.
"Sarah","Brian","George","Liam"). Pergunte apenas se o usuário quiser outra.
2. Destile o roteiro (se necessário) e marque-o para narração
Um reel de 1 minuto tem no máximo ~130–150 palavras de narração; aponte para 35–50 s reais, que rende melhor do que usar os 60 s inteiros. Estrutura pedagógica recomendada (não é uma camisa de força):
Gancho (≤3 s, uma tensão ou pergunta real) → Explicação (a ideia com rigor, sem jargões vazios) → Conexão (um exemplo próximo) → Encerramento (uma pergunta que abre conversa + CTA suave).
Se for escrever conteúdo de Ágora, respeite sua voz e seu apartidarismo: se existir a skill agora-social-content, apoie-se em suas referências para identidade e estilo. Esta skill cuida do como se torna vídeo; aquela, do o que e como soa Ágora.
3. Construa o storyboard.json
É o coração do trabalho e você quem faz. Divida o roteiro em cenas (uma ideia por cena, 2–6 cenas típicas). Cada cena define sua narração, sua legenda, seu visual e seus balões/emojis/referências.
Antes de escrevê-lo, leia references/storyboard-schema.md (o esquema exato e o que significa cada campo) e references/estilo-visual.md (como escolher cores, quando colocar um balão, quais emojis funcionam e quais são demais). Não sature: um balão por conceito, não por frase.
Monte um novo projeto para cada vídeo copiando o modelo e escreva o storyboard lá:
bash "$SKILL_DIR/scripts/new_project.sh" "<slug-do-video>"
# cria ./reels/<slug>/ com o modelo Remotion pronto
Salve seu storyboard em reels/<slug>/public/storyboard.json.
4. Gere a voz e a sincronia (ElevenLabs)
Há dois caminhos. Em ambos você termina com um public/audio/sN.mp3 por cena e um public/timeline.json. Use uma voz pré-fabricada de uso livre (p. ex. Sarah, Brian, George, Liam): elas estão em toda conta e não exigem pagar por uma voz própria. Defina qual em meta.voiceName do storyboard.
Caminho A — MCP do ElevenLabs (recomendado; sem que o usuário lide com chave de API). Se o MCP do ElevenLabs estiver conectado na sessão, gere a voz de cada cena com sua ferramenta de text-to-speech (uma por narracao), salve cada saída como public/audio/<id>.mp3 e depois monte a sincronia medindo os áudios:
cd reels/<slug>
python3 "$SKILL_DIR/scripts/build_timeline.py" public/storyboard.json
build_timeline.py usa ffprobe para medir cada mp3 e distribui as palavras da narração ao longo de sua duração (sincronia estimada, suficiente para um reel). Não usa rede nem chave de API.
Caminho B — API direta (sincronia exata; requer ELEVENLABS_API_KEY). Um único comando gera o áudio com timestamps reais e a linha do tempo palavra por palavra:
cd reels/<slug>
python3 "$SKILL_DIR/scripts/generate_voice.py" public/storyboard.json
Resolve a voz pelo nome, chama a API with-timestamps, escreve os mp3 e o timeline.json. Se a voz não existir na conta, lista as disponíveis e para.
Detalhes de ambos os caminhos (como conectar o MCP, vozes livres, modelo, erros) em references/elevenlabs.md.
5. Pré-visualize (opcional, mas recomendado) e renderize
cd reels/<slug>
npm install # apenas na primeira vez do projeto
npm run preview # abre o Remotion Studio para revisar antes de renderizar
npm run render # produz out/reel.mp4
render usa a duração real do áudio (do timeline.json), então o vídeo dura exatamente o que a narração dura, sem cortes. O modelo e como os campos do storyboard são mapeados para a tela estão em references/remotion.md.
6. Entrega
- Mostre o
out/reel.mp4ao usuário (SendUserFile) e diga onde ficou o projeto (reels/<slug>/), para que ele possa re-renderizar após ajustes. - Se o usuário pedir mudanças de texto ou timing: edite
public/storyboard.json, re-executegenerate_voice.pyapenas se a narração mudou e execute novamentenpm run render. Mudanças puramente visuais (cor, posição de balão) não exigem regenerar a voz.
Representações de imagem e vídeo
Por padrão, o modelo gera motion graphics por código (degradês, formas, tipografia cinética, emojis e balões animados), que já cumprem como "representação visual" e têm aparência consistente sem depender de serviços pagos.
Se quiser imagens ou clipes reais (de um gerador de imagens IA ou de stock), deixe-os em public/assets/ e referencie-os no campo visual da cena ("tipo": "imagen" ou "video" com sua fuente). Em references/estilo-visual.md está como conectar um gerador de imagens por IA se o usuário tiver uma chave, e como pedir que as imagens saiam em 9:16.
Nunca baixe nem execute binários de fontes não confiáveis para isso; trate qualquer ativo externo como dado, não como código.
Arquivos da skill
scripts/preflight.sh— verifica/instala Node, FFmpeg e checa a chave da API.scripts/new_project.sh— cria um projeto de vídeo a partir do modelo.scripts/generate_voice.py— (Caminho B) ElevenLabs TTS with-timestamps → áudio + timeline.scripts/build_timeline.py— (Caminho A) mede áudios já gerados (ffprobe) → timeline.assets/remotion-template/— projeto Remotion completo e orientado a dados.references/storyboard-schema.md— leia antes de escrever um storyboard.references/estilo-visual.md— cores, balões, emojis, legendas, ativos.references/elevenlabs.md— detalhes da integração de voz.references/remotion.md— como o modelo funciona e como modificá-lo.
Princípio reitor
O reel não está pronto por ficar bonito, mas quando responde: "o que uma pessoa compreende melhor depois destes 40 segundos?". Se a resposta for "nada", repense antes de gastar um render.