Communitygithub.com

reel-educativo-ia

Cria vídeos curtos verticais (reel/short, máximo 1 minuto) com objetivo pedagógico, gerados do início ao fim com IA e código a partir de um roteiro. O pipeline converte o roteiro em um storyboard, gera a narração com ElevenLabs — usando uma voz pré-fabricada de uso livre, via seu MCP ou sua API — e renderiza com Remotion um MP4 9:16 com diálogos, legendas sincronizadas tipo karaokê, representações visuais (imagem/vídeo ou motion graphics) e referências com emojis e balões sobre o conteúdo.

O que é reel-educativo-ia?

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 final do 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. Ela é útil para educadores, criadores de conteúdo e desenvolvedores que desejam transformar rapidamente textos explicativos em vídeos curtos para redes sociais (Instagram Reels, TikTok, YouTube Shorts). Suporta as plataformas Reels, TikTok e Shorts, e funciona com Node.js, FFmpeg, Python, ElevenLabs (via MCP ou API) e Remotion. O fluxo de trabalho é: roteiro → storyboard.json (gerado por você, Claude) → voz + sincronia (ElevenLabs) → render (Remotion) → `reel.mp4`.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MaaCamii/skill-educativo-video-ia/tree/HEAD/reel-educativo-ia

Perguntar na sua IA favorita

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

Documentação

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:

  1. Narração (ElevenLabs) — narra o roteiro.
  2. Legendas sincronizadas palavra por palavra (estilo karaokê), legíveis no modo mudo, que é como a maioria dos reels é consumida.
  3. Representação visual — fundo com motion graphics gerados por código e/ou imagens/clipes (de IA ou stock) que ilustram a cena.
  4. 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.mp4 ao 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-execute generate_voice.py apenas se a narração mudou e execute novamente npm 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.

Habilidades Relacionadas