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á.