Communitygithub.com

MrRoam/explainer-video-skill

Cria vídeos explicativos em chinês, vídeos de divulgação científica, animações de princípios ou vídeos no estilo 3B1B. Usa Codex para roteiro e storyboard, reutilizando Manim local, dublagem Kokoro e FFmpeg para exportar MP4 e legendas. Ideal para 'fazer um vídeo explicando X'; não ativar quando apenas texto, imagens estáticas ou edição simples de vídeo forem necessários.

O que é explainer-video-skill?

Este skill permite que agentes de IA (como Codex, Claude Code ou Cursor) criem vídeos explicativos animados em chinês, inspirados no estilo 3Blue1Brown. Ele automatiza todo o fluxo de produção: o agente gera o roteiro e o storyboard, enquanto ferramentas locais como Manim, Kokoro (TTS) e FFmpeg cuidam da animação, dublagem e renderização final. O resultado é um vídeo MP4 de cerca de 1 minuto, 720p e 30 fps, com legendas SRT e código fonte reutilizável. O principal diferencial é a abordagem centrada em demonstrações visuais e intuição matemática, com fundo escuro, cores de destaque limitadas e transições contínuas. O skill é configurado para usar recursos locais (CPU, modelos de voz pré-baixados) e não depende de APIs externas caras. Ele suporta Windows (via PowerShell script de setup) e pode ser facilmente adaptado para outros sistemas. Ideal para educadores, criadores de conteúdo e desenvolvedores que desejam produzir vídeos explicativos de alta qualidade de forma automatizada e controlada.

Funciona com~Claude Code✓Codex CLI~Cursor
npx skills add MrRoam/explainer-video-skill

Perguntar na sua IA favorita

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

Documentação

Vídeo Explicativo em Chinês

Entrega vídeos personalizados prontos para reprodução. O Codex é responsável pelo conteúdo e código de animação, enquanto as ferramentas locais cuidam da dublagem, renderização e composição. Padrão: chinês, para iniciantes, aproximadamente um minuto, 720p, 30 fps; as solicitações do usuário na sessão têm prioridade.

Por padrão, adota a abordagem de raciocínio gráfico do 3Blue1Brown: fundo escuro, poucas cores de ênfase com significados fixos, mudanças contínuas nos gráficos, zoom localizado e transformações correspondentes entre fórmulas e gráficos. Primeiro constrói a intuição, depois apresenta a fórmula. Cria roteiro e cenas originais para o tópico atual.

Ferramentas Reutilizadas

A configuração local está em runtime.local.json na raiz do skill, ou pode ser especificada via EXPLAINER_RUNTIME ou --runtime. Primeiro verifica Python, FFmpeg, modelo de dublagem e fontes chinesas disponíveis na configuração. Se faltar configuração, siga o README.md para configurar o ambiente existente ou instalar dependências ausentes. Não configure serviços permanentes apenas para teste nem reinstale ambientes reutilizáveis.

No Windows, a instalação inicial pode executar scripts/setup.ps1, que instala automaticamente as dependências de CPU necessárias, baixa modelos chineses e salva a configuração local. Se já houver configuração válida, apenas verifica os caminhos; o script não instala Python, TeX ou CUDA. Se as ferramentas existentes estiverem em outros diretórios, passe os caminhos do ambiente e do modelo correspondentes para reutilizá-los.

python "SKILL_DIR\scripts\init_project.py" --workspace "WORKSPACE" --name concept-video

SKILL_DIR é o diretório atual do skill, WORKSPACE é o caminho absoluto do workspace atual. O script apenas copia modelos pequenos, não baixa dependências. O código fonte está em outputs/concept-video-project, o cache em work/explainer/concept-video. Use nomes diferentes para vários vídeos; reconfigure os caminhos se as ferramentas forem movidas.

Escrita e Produção

Modifique simultaneamente lesson.json e scene.py no projeto. O modelo é um exemplo de derivada; apenas mudar o título não criará um novo tópico. Consulte references/pipeline.md para campos, sincronização de storyboard e comandos de execução.

Escolha um problema específico, vá do exemplo ao princípio. Cada narração corresponde a uma mudança observável, como movimento de ponto, mudança de curva, atualização de variável ou revelação gradual de relação. Conclusões matemáticas devem declarar as condições de validade; legendas, fórmulas e números devem ser consistentes com o roteiro. Fontes da configuração local; MathTex no modelo requer TeX; se TeX estiver ausente, use Text e objetos geométricos.

Por padrão, usa Kokoro versão chinesa local, CPU e vozes já baixadas, sem necessidade de modelos grandes adicionais ou APIs de voz. Símbolos matemáticos, LaTeX e termos em inglês na narração devem ser reescritos para a pronúncia chinesa. Faça primeiro uma prévia curta, depois gere o vídeo completo; não baixe automaticamente todas as vozes nem troque o backend de dublagem sem aviso. Outros áudios podem ser integrados conforme references/pipeline.md.

Verificação e Entrega

Primeiro gere uma prévia em baixa resolução para verificar chinês, fórmulas, sobreposições e limites, depois exporte o vídeo final. Verifique se a narração não está silenciosa, cada segmento está completo e o final não está cortado. O script de renderização verifica tamanho e sincronização de tempo, mas a inspeção visual e auditiva ainda é necessária.

Entregue MP4, SRT, roteiro em chinês e código fonte refazível. Coloque os arquivos de entrega em outputs do workspace e os arquivos intermediários em work. Informe o backend de dublagem real e as limitações não resolvidas; não descreva o sucesso do script como se o usuário já estivesse satisfeito com a qualidade do áudio.

Habilidades Relacionadas