Communitygithub.com

triptu/create-explainer-videos

Crie um vídeo explicativo narrado e legendado a partir de qualquer coisa — URL de blog ou artigo, artigo acadêmico, pull requests, branches, diffs, repositórios ou anotações — ou revise um já existente. Gatilhos: 'make a video of…', '/video <link|PRs|repo>', 'explain this as a video', 'video walkthrough of these PRs' ou alterações em um vídeo anterior.

O que é create-explainer-videos?

Esta skill transforma qualquer entrada textual ou técnica em um vídeo explicativo profissional, narrado e legendado, que alguém escolheria assistir em vez de ler a fonte original. Compatível com plataformas como Claude Code e similares, ela é acionada por comandos como 'make a video of…', '/video' ou 'explain this as a video'. A skill prioriza a automação inteligente: o agente lê e compreende profundamente o material — seja um artigo, PRs, diffs ou notas soltas —, encontra a história central, escreve uma narração natural e precisa, e cria visuais animados personalizados (diagramas, capturas de tela, snippets de código destacados) para cada cena. O fluxo de trabalho é iterativo: gera imagens de verificação, permite pré-visualização e renderiza o vídeo final, sempre reportando suposições e limitações. A audência é considerada inteligente mas não familiarizada com a fonte, exceto para PRs/código, onde o foco é facilitar a revisão. A skill não substitui a leitura completa; ela exige que o agente consuma todo o material, use ferramentas como busca web, `gh` e execução de código para preencher lacunas, e evite simplificações que distorçam os fatos.

Funciona com✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/triptu/create-explainer-videos/tree/HEAD/.claude/skills/video

Perguntar na sua IA favorita

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

Documentação

Vídeo

Transforme o que o usuário fornecer em um vídeo que alguém realmente escolheria assistir em vez de ler a fonte original: história clara, visuais reais, cada cena em movimento e afirmações precisas.

Todos os vídeos ficam neste estúdio (pasta videos/ deste repositório). Leia CLAUDE.md primeiro: ele contém os comandos, fluxo de trabalho, convenções de cena e pegadinhas. Esta skill trata do julgamento; o CLAUDE.md trata da mecânica. Nunca crie um novo projeto do zero. Use npm run new ou edite um vídeo existente em videos/ no lugar.

Como trabalhar

Execute do início ao fim. Faça suposições razoáveis, construa o vídeo e relate o que supôs. Pause para perguntar apenas se o usuário pediu explicitamente para confirmar, ou se você estiver realmente travado (a fonte está inacessível ou não está claro quais PRs ou escopo ele quer dizer).

Seja engenhoso. Busque o melhor vídeo possível, não o mínimo que funciona a partir do que foi fornecido. Use qualquer ferramenta que ajude: busca web, referências da fonte e páginas vinculadas, posts ou documentação relacionados, trabalhos anteriores do autor, gh, clonar e executar código, o produto ao vivo e outras skills. Preencha o contexto faltante, verifique afirmações, encontre visuais melhores e descubra o que um termo ou sistema significa, em vez de adivinhar. Uma fonte limitada não o limita ao que está nela. Se uma abordagem falhar, tente outra antes de se contentar com menos.

Padrões de audiência:

  • Artigos, posts e artigos acadêmicos: um espectador inteligente que não leu a fonte.
  • PRs, branches, repositórios e código: interno. O espectador é o usuário, que quer entender o que foi feito, muitas vezes porque está prestes a revisar. Otimize para "Agora eu poderia revisar ou discutir isso com confiança." Torne-o um vídeo público ou de lançamento apenas quando o usuário disser explicitamente.

A duração segue o conteúdo. Um PR pequeno e único pode ter 1–2 minutos; um post denso, 5–8. Não encha linguiça nem amontoe. Uma ideia por cena.

1. Entenda melhor que uma lida superficial

Acesse o material principal e leia tudo antes de escrever uma palavra.

  • Links e artigos: busque a página em si. HTML bruto primeiro, depois Playwright se for renderizado no cliente, se você precisar ver ou gravar visuais, ou se estiver bloqueado (veja CLAUDE.md). Nunca trabalhe a partir de um resumo. Obtenha o texto completo e todas as figuras, vídeos e elementos interativos. Se estiver atrás de login, informe.
  • PRs e diffs: descrição, diff completo, commits, threads de revisão, issues vinculadas, resultados de CI. Leia o código ao redor também, não apenas as linhas alteradas: chamadores, fluxo de dados, testes. Descubra por que foi feito, quais eram as alternativas e onde está o risco. Se ver o comportamento ajudar, execute e capture antes/depois.
  • Repositórios: pontos de entrada, arquitetura, o fluxo principal de dados ou controle e o que é incomum.
  • Anotações ou um tópico: pesquise o suficiente para estar correto e cite de onde vieram as afirmações.

2. Encontre a história

Decida primeiro a conclusão em uma frase, depois o arco que a justifica. Geralmente é: o problema, a ideia central, como funciona, a evidência e o que significa. Para vídeos de PR com foco em revisão, cubra também: a forma da mudança, as decisões importantes, o que é arriscado ou sutil, como é testado e onde um revisor deve olhar.

Escreva a narração para ser ouvida, com suas próprias palavras. Mantenha números exatos, nomes e citações da fonte, e nunca invente métricas. Se simplificar, mantenha-se fiel à verdade.

Voz: Kokoro por padrão. Se o usuário quiser uma voz mais natural, ou se .env tiver OPENROUTER_API_KEY, use Gemini TTS (CLAUDE.md, "Vozes").

3. Torne visual

  • Artefatos reais primeiro: figuras e gravações da própria fonte, UI real (capturas de tela ou gravações do aplicativo em execução) e código real exibido como snippets focados com linhas destacadas, nunca paredes de código.
  • Diagramas animados personalizados para todo o resto: fluxos, antes/depois, arquitetura, números que contam, comparações. Cada cena deve ter algo em movimento que explique a ideia, em sincronia com as palavras.
  • Tema: combine com a marca da fonte. Para código sem marca, use o visual do produto ou um tema limpo e amigável para código.

4. Verifique, então entregue

Siga o loop de verificação → imagens estáticas → pré-visualização → renderização completa descrito no CLAUDE.md. Olhe as imagens estáticas e corrija o que você vê, incluindo sobreposições, trechos vazios, texto ilegível e sincronia que não corresponde às palavras. Em seguida, relate: o caminho de saída, duração, o que o vídeo cobre, o que você verificou e quaisquer suposições ou lacunas. Diga claramente que você não o assistiu do início ao fim.

Deixe o estúdio melhor

Se você encontrar uma pegadinha reutilizável, adicione-a ao CLAUDE.md. Se você construiu algo que outros vídeos vão querer (uma cena de diff de código, uma linha do tempo de PR, um primitivo de gráfico), mova-o para lib/ ou templates/default. Os ativos gerados em videos/*/public/ estão no .gitignore, portanto, qualquer coisa que um clone novo não consiga regenerar (mídia baixada, imagens feitas à mão) deve ser obtida por um script, não apenas colocada lá.

Habilidades Relacionadas