Communitygithub.com

gdoteof/explainers

Executa o pipeline conversa → pesquisa → roteiro → voz → vídeo no repositório explainers (~/claude/explainers) — entrevista o proprietário para descobrir o que um vídeo deve argumentar, pesquisa em uma ficha de fontes, escreve um roteiro cujas batidas são rotuladas como fato/estimativa/visão/opinião/especulação/linha, verifica, narra com a voz local, desenha as cenas em Skia (manim para gráficos), renderiza e escreve a descrição. Use quando o usuário quiser discutir ideias para um vídeo, quiser criar ou modificar um vídeo explicativo, redigir ou verificar fatos de um roteiro, ou mencionar o pipeline explainers ou o apresentador Footnote.

O que é explainers?

Esta skill define um pipeline completo de produção de vídeos explicativos, desde a conversa inicial com o proprietário até a renderização final. Ela suporta plataformas como Claude Code, Cursor e Codex. O processo começa com uma entrevista em estilo conversacional para extrair uma tese central e objeções fortes, seguida por pesquisa rigorosa com fontes verificadas. O roteiro é estruturado em 'batidas' rotuladas por tipo (fato, estimativa, visão, opinião, especulação, linha), garantindo transparência sobre o que é evidência versus interpretação. A narração é feita com voz sintética ou gravada pelo usuário, e as imagens são desenhadas em Skia (com manim para gráficos) em um cenário de sala de aula. A skill enfatiza checkpoints frequentes para aprovação do usuário e usa ferramentas como `uv run`, `explainers.check` e `explainers.describe`. É ideal para criadores que desejam transformar ideias em vídeos explicativos bem fundamentados, com ênfase em clareza, precisão e envolvimento do público.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/gdoteof/explainers/tree/HEAD/.claude/skills/explainer-video

Perguntar na sua IA favorita

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

Documentação

Vídeo explicativo

Trabalhe a partir da raiz do repositório com uv run. O README.md contém os comandos e formatos de arquivo; o EDITORIAL.md é o padrão. Esta é a ordem de trabalho e onde estão os pontos de verificação do usuário.

0. A conversa, onde um vídeo começa

Os vídeos surgem do que o proprietário pensa, testado, não de uma lista de tópicos. Antes de qualquer pesquisa, entreviste-o.

  • Uma ou duas perguntas por vez, em conversa simples e curta: o proprietário responde por ditado, e cinco de uma vez eram muitas para responder ou manter o fio. Ao longo das rodadas, misture os tipos: perguntas abertas ("o que cada lado está protegendo?"), quizzes que ele responde antes de você procurar a resposta ("qual parcela você diria?"), testes de aço ("apresente o caso do outro lado de modo que eles concordariam"), e iscas: a objeção mais forte ao que ele acabou de dizer, colocada de forma direta. Siga a resposta que te surpreendeu, não a próxima pergunta de uma lista.
  • Os palpites errados do proprietário podem aparecer na tela: ele concordou com isso. Mas um número é um palpite dele apenas se ele o ofereceu como palpite. Um número dentro de um exemplo ("digamos que eles gastem 70% em contas...") é uma ilustração: registre-o como tal, nunca pontue ou mostre como palpite, e pergunte quando não estiver claro qual dos dois era.
  • Escute a afirmação por trás da resposta: uma tese que pode estar errada, uma distinção que ele insiste em fazer, uma história dele mesmo. Esses são vídeos. Um tópico ("aborto") não é uma ideia; "os dois lados estão respondendo perguntas diferentes" é uma.
  • Mantenha as palavras dele. Salve as respostas na íntegra e datadas em notes/<tópico>.md, que o git ignora: as notas são brutas e privadas, e o roteiro é a forma publicada. Marque seus próprios resumos como seus.
  • Classifique o que ele disse pelo que o roteiro precisará. O que pode ser verificado vira pesquisa, depois batidas de fact, estimate ou view. O que é dele vira opinion ou speculation. Esclareça palavras carregadas de significado antes que avancem ("engenhado": por quem, e como saberíamos?), e diga a ele claramente quando as fontes não sustentam algo que ele acredita.
  • Pare quando houver uma tese, três ou quatro movimentos que a sustentam, e a objeção mais forte a ela. Reproduza isso em poucas linhas e obtenha um sim antes de pesquisar.

O proprietário quer como as coisas funcionam agora. De onde algo veio é uma breve digressão dentro de um vídeo, não o vídeo.

1. Pesquisa, antes de qualquer roteiro

  • Estabeleça a pergunta que o vídeo responde em uma frase, e as três ou quatro coisas que um espectador deve ser capaz de dizer depois.
  • Construa uma ficha de fatos: uma afirmação por linha, cada uma com uma fonte que foi buscada e lida nesta sessão e a passagem que a sustenta. Mantenha as fontes em videos/NOME/sources.toml desde o primeiro dia (uma pasta com apenas esse arquivo é um vídeo sendo pesquisado, ou pausado) e as afirmações em notes/NOME.md. Pesquisar em um subagente é aceitável, mas diga a ele para retornar citações literais e marcar o que não conseguiu sustentar; nunca aceite uma URL que ele não abriu.
  • Para um tópico controverso, colete o caso de cada lado a partir de seus próprios defensores mais fortes, e anote quais discordâncias são sobre fatos e quais são sobre valores.
  • Escreva o que as fontes NÃO sustentam. Versões populares de uma história são frequentemente mais arrumadas do que a evidência.

2. Roteiro (ponto de verificação: o usuário o aprova)

  • python -m explainers.new NOME (preenche em torno de um sources.toml que já existe), depois script.md.
  • Um vídeo dura de 12 a 25 minutos: cerca de 2.100 a 4.400 palavras no ritmo de leitura do proprietário (cerca de 175 palavras por minuto com as pausas). Dê a ele seções que o espectador possa sentir a transição, cada uma com sua própria pergunta.
  • Uma ideia por batida, uma batida por respiração: 15 a 40 palavras. Escreva para o ouvido: frases curtas, a palavra importante por último, números arredondados para o que um ouvinte consegue reter, sem colchetes ou abreviações.
  • Abra com a pergunta ou a surpresa, não com uma saudação. Cada seção deve deixar o espectador querendo a próxima.
  • Rotule pelo que a frase promete, não pelo quão certo você se sente. Divida uma batida que mistura tipos. Um roteiro que é principalmente fact e view com algumas batidas opinion claramente marcadas é o objetivo; check imprime a divisão.
  • Não escreva a opinion do canal sobre uma questão controversa você mesmo. Deixe uma lacuna marcada, ou rascunhe uma e diga claramente que é um rascunho para o usuário aceitar, alterar ou cortar.
  • Coloque uma nota > sob cada seção dizendo o que está na tela. Toda batida precisa de uma imagem que mude pelo menos a cada cinco segundos ou mais.
  • python -m explainers.check videos/NOME --urls deve passar. Mostre ao usuário o roteiro com a divisão e a lista de fontes.

3. Voz (ponto de verificação: o usuário a grava)

  • Rascunhe com a voz sintética: python -m explainers.narrate videos/NOME. Corrija as palavras que ela adivinhou em say.txt. Adicione pause a uma batida quando sua imagem precisar de tempo para ser assimilada. As imagens podem ser construídas e o roteiro finalizado neste rascunho.
  • Quando a redação estiver finalizada, o usuário a grava em um terminal próprio: python -m explainers.record videos/NOME mostra cada batida, grava e verifica a tomada quanto ao nível e às palavras do roteiro. --room grava a sala vazia uma vez, para os intervalos. Depois narrate novamente: ele usa uma tomada onde houver uma nova. As imagens permanecem em suas palavras, já que as deixa são procuradas por palavra, mas as batidas mudam de duração: execute sweep e veja uma folha de contato antes de renderizar.
  • O usuário não precisa ler palavra por palavra. Onde uma tomada se desvia do roteiro, record mostra a diferença e, se ele a mantiver, reescreve a batida em script.md para o que ele disse. Portanto, faça commit do roteiro antes de ele gravar e, depois, leia git diff dele: corrija a ortografia e pontuação das novas palavras (isso não torna uma tomada obsoleta) e, para cada fact, estimate ou view alterado, leia a citação da fonte em comparação com as novas palavras. Se não as sustentar mais, avise o usuário: a batida é lida novamente ou reetiquetada, não deixada passar.
  • Reformular você mesmo uma batida gravada custa ao usuário uma nova leitura. Agrupe tais alterações e pergunte primeiro.
  • --audition VOICE ... compara vozes sintéticas para o rascunho; a linha voice: do roteiro escolhe uma.

4. Imagens

  • Comece a partir do video.py do modelo e substitua cena por cena. Uma cena por seção é a granularidade usual; corte entre elas com theme.scenes.
  • Um vídeo acontece em um cenário (explainers/sets.py): até agora uma sala de aula com uma tela de projetor, que foi o que o proprietário pediu. Desenhe um gráfico, um cartão ou uma figura como um slide, uma imagem de 1920x1080, e entregue ao cenário: o mesmo slide está na tela no plano geral e preenche o quadro quando a câmera se aproxima (sets.shots para os movimentos). Aproxime quando o slide precisar ser lido, afaste quando o apresentador tiver algo a fazer, e desligue o projetor (on) quando o apresentador der um passo à frente com uma opinião. Coloque o título da seção no quadro (chalk) e dê à etiqueta um plate para que seja legível sobre o ambiente. As notas > de um roteiro dizem "Amplo" ou "Projetor". Outros cenários virão: mantenha um slide livre do ambiente.
  • Pendure cada movimento em uma deixa: N.at(batida, palavra). Nunca digite um tempo em segundos.
  • O apresentador é pequeno e de lado enquanto algo é explicado, e grande quando fala por si mesmo (abertura, opinião, fechamento). Ele olha e aponta para o que está sendo falado.
  • Gráficos, gráficos e qualquer coisa matemática vão em um Insert do manim. Todo o resto é Skia.
  • Os lados de um argumento são theme.SIDE_A / theme.SIDE_B. Um conjunto de dados que um gráfico desenha é salvo no data/ do vídeo com sua origem e data.
  • Loop: preview uma seção, veja a folha, corrija, repita; sweep antes de cada renderização.

5. Renderizar e entregar (ponto de verificação: o usuário assiste)

  • python -m explainers.render videos/NOME --fresh, depois python -m explainers.describe videos/NOME.
  • Relate o que foi verificado e o que não foi, qualquer batida cujo rótulo foi uma decisão subjetiva, e qualquer coisa que a voz diga de forma estranha.

Habilidades Relacionadas