Communitygithub.com

why-explainer-video

Escreve e prepara vídeos educativos do YouTube de 20 minutos no formato 'Why Evolution Made…' (estilo Apefully): um paradoxo sobre o corpo ou comportamento humano, aberto por uma cena cotidiana em segunda pessoa, resolvido por capítulos 'cientista + ano + número + analogia', virado em 'não era um defeito, era uma troca' e fechado com um retorno à cena e uma pergunta para os comentários. Produz o roteiro completo (3.300–3.600 palavras), a lista de imagens uma por frase para um slideshow 2D sem animação (prompts com prefixo de estilo, famílias de planos, gráficos por código), o título, a miniatura 'WHY … ?', os capítulos, a descrição, as tags e a categoria, e gera as imagens automaticamente no Google Flow (Chrome controlado por Playwright, scripts inclusos) e a miniatura por código. Use sempre que o usuário quiser um vídeo educacional sem rosto, um explicador de ciência ou evolução, um vídeo 'por que os humanos…', 'por que a evolução…', 'a verdadeira razão…', um explicador 2D de boneco palito ou estilo lousa.

O que é why-explainer-video?

Este skill automatiza a produção de vídeos explicativos no estilo 'Why Evolution Made…' (como o canal Apefully), focando em paradoxos humanos que o espectador carrega consigo (calvície, olhos azuis, envelhecimento). Ele gera um roteiro completo de 3.300 a 3.600 palavras, estruturado em 8 a 11 capítulos baseados em fatos científicos (cada um com nome de cientista, instituição, ano e número), uma virada emocional ('não era um defeito, era uma troca') e uma cena de abertura em segunda pessoa. Além do roteiro, o skill produz uma lista de imagens uma por frase (para um slideshow 2D sem animação) com prompts completos, e gera as imagens automaticamente usando Google Flow e Playwright, além da miniatura 'WHY … ?' por código. Suporta plataformas como Claude Code, Cursor e Codex, e é ativado por frases como 'vídeo explicativo', 'por que a evolução', 'roteiro educacional 20 minutos' ou 'miniaturas WHY'. O fluxo inclui seleção de tema com o 'teste do espelho', reunião de fatos verificados, escrita com regras de densidade de dados e voz, construção visual com cinco famílias de planos, geração automática de imagens, e checklist de qualidade antes da entrega.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/kamalammouri/faceless-video-skills/tree/main/skills/why-explainer-video

Perguntar na sua IA favorita

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

Documentação

Vídeo Explicativo Why (formato "Why Evolution Made…")

Reproduz o formato medido no canal Apefully (19 mil inscritos, 2,8 milhões de visualizações em 5 semanas, um vídeo por dia): um paradoxo humano explicado em 20 minutos por meio de um slideshow de imagens fixas. O skill contém a lógica, não um tópico: cada pedido = um novo tópico.

Idioma e saída

  • Responder no idioma do usuário. Roteiro em inglês por padrão (o formato vive no público anglófono e a dublagem automática faz o resto).
  • Entregar um único arquivo .md no diretório atual: roteiro, depois lista de imagens, depois publicação.

A fórmula

UM PARADOXO QUE O ESPECTADOR CARREGA EM SI (calvície, olhos azuis, náuseas, envelhecimento)
+ ABERTURA: UMA CENA FÍSICA DO COTIDIANO EM SEGUNDA PESSOA
+ A CRENÇA FALSA, DEPOIS A PROMESSA DE UM TWIST NO FINAL
+ 8 A 11 CAPÍTULOS: UM CONCEITO NOMEADO = UM CIENTISTA + UM ANO + UM NÚMERO + UMA ANALOGIA
+ A VIRADA: "NÃO ERA UM DEFEITO, ERA UMA TROCA" (trade-off)
+ RETORNO À CENA DE ABERTURA, SENTIDO INVERSO, DEPOIS UMA PERGUNTA AOS COMENTÁRIOS

Por que funciona: o título promete que a resposta conhecida é falsa; a cena de abertura faz do espectador o sujeito; os nomes, datas e números dão credibilidade que compensa o título chamativo; a virada gera emoção ("você não está quebrado"); a pergunta final preenche os comentários.

Fluxo de trabalho

  1. Escolher o tópico com o teste do espelho (seção 1). Se o usuário não fornecer um, propor 3 e pegar o primeiro. references/topic-bank.md para ideias e tópicos a evitar.
  2. Reunir os fatos: 3 a 5 estudos ou cientistas nomeados, com ano, instituição e um número cada. Pesquisar na web; nunca inventar um nome, ano ou número. Marcar [verificado] no rascunho.
  3. Escrever o roteiro com references/script-template.md (mecânica de cada parte, orçamentos de palavras) e as regras da seção 3.
  4. Construir a lista de imagens com references/visual-pipeline.md: uma imagem por frase, família de plano, prompt completo; cartões de números por scripts/cards.py (ícone obrigatório, layouts em rotação); depois auditoria pelos agentes Diretor visual e Auditor de prompts.
  5. Gerar as imagens: cenas com personagem pelo Google Flow, automaticamente com references/flow-automation.md (scripts em scripts/flow/); ícones, esquemas, gráficos e cartões por código. Depois montar (voz + imagens) e verificar em uma prancha de contato.
  6. Publicação: a ficha completa de references/publication-seo.md §0, com a categoria Educação sempre escrita, a miniatura texto por código, os capítulos sincronizados com a voz.
  7. Controle de qualidade (seção 5) depois entrega.

Agentes de produção

O redator sozinho se repete; a produção passa por agentes especializados lançados em paralelo com a ferramenta Agente, cada um com um briefing completo (references/agents.md): Verificador de fatos e Crítico de roteiro após o rascunho; Diretor visual e Auditor de prompts após a lista de tomadas; QC de imagens (visão) após cada lote de imagens; Verificador de publicação antes da entrega. O orquestrador aplica suas tabelas de correções e relança o que precisar. Nunca pular Diretor visual e QC de imagens: são eles que impedem cartões nus, bolhas vazias e duplicatas.

1. O teste do espelho (escolha do tópico)

Um tópico funciona quando o espectador pode se olhar no espelho e se reconhecer: calvície, olhos azuis, barba, curvas, altura, envelhecimento, morte. Em 29 vídeos do canal de referência, esses tópicos têm 146.000 visualizações medianas; tópicos médicos sem autoidentificação (náuseas de gravidez, perda de cabelo feminina, parto) e emoções abstratas (tristeza, amor) têm 7.000 a 14.000.

Antes de escrever, verificar: (a) uma em cada três pessoas pode dizer "sou eu"; (b) existe uma resposta óbvia que o vídeo vai contradizer; (c) existem pelo menos 3 estudos nomeáveis.

2. Estrutura calibrada (alvo 20 a 24 min, 3.300 a 3.600 palavras a 155–170 palavras/min)

#ParteTempoPalavrasConteúdo
1Cena de abertura0–4%120–170Segunda pessoa, um gesto, um lugar, uma hora, sensações. Nunca abstração em primeiro lugar.
2Crença falsa + promessa4–8%120–160"Society tells you…" / "the version you learned in ninth grade…"; depois "it is not a flaw, it is a…"; depois a promessa: "near the end, we will see why…"
3Capítulos 1 a 4: o contexto ancestral8–35%900–1.000O mundo de antes (savana, 200.000 anos), o mecanismo, o primeiro cientista, o primeiro número
4Capítulos 5 a 7: as evidências35–60%800–9002 ou 3 estudos com nome + instituição + ano + amostra + resultado numérico
5CTA de inscrição integrado≈ 60%40–60Uma frase que brinca com o tópico ("clicking subscribe contains zero bitter alkaloids"), depois retoma: "because we are about to uncover…"
6Capítulos 8 a 10: o twist prometido60–88%700–800A descoberta recente, o mecanismo oculto, o paradoxo resolvido
7Virada88–95%200–250"You were never broken"; o defeito é uma troca; levantar a culpa
8Retorno à cena + pergunta95–100%120–160Mesmo lugar, mesmo gesto da abertura, sentido inverso; uma pergunta precisa aos comentários

Capítulos do YouTube: 8 a 11, de 2 a 3 minutos, nomeados "The [Nome] of [Coisa]" (The Riddle of…, The Hidden Cost of…, The … Mechanism, The Final Verdict).

3. Regras de escrita

3.1 Voz

  • Segunda pessoa na abertura, virada e final; terceira pessoa nos capítulos científicos. Alvo: 2 "you/your" para 100 palavras (o vídeo com 542 mil visualizações tem 2,0; aquele com 10 mil tem 1,0).
  • Presente, frases de 15 a 25 palavras, uma imagem mental por frase (cada frase vira uma imagem na tela).
  • Tom: documentário caloroso, nunca zombeteiro. O título é chamativo, o texto não é.

3.2 Densidade de fatos

  • 40 a 90 números por roteiro (anos, porcentagens, amostras, durações).
  • Cada capítulo: pelo menos um cientista nomeado + instituição + ano, e um número preciso ("tracked nearly 800 pregnancies", "27 traditional societies", "doubles every 8 years").
  • Cada conceito abstrato recebe uma analogia cotidiana em uma frase (botas gastas, sifão, linha costeira, guarda de fronteira, torre de rádio).

3.3 As palavras-chave do formato

  • O pivô sempre se chama trade-off / bargain / contract.
  • Os verbos da evolução: made, gave, let, forced, refused, insisted, invented, traded away. A evolução é um personagem que decide.
  • Frases a colocar: "It was never a glitch." "You are looking at…" "Here is the strange reality…" "Pause and let that sink in."

3.4 Laços abertos

  • Uma promessa explícita na parte 2, cumprida na parte 6 ("the ultimate twist we promised at the start").
  • Duas retomadas "and that raises a bigger riddle" entre os capítulos.

3.5 Escrever para uma voz de IA

  • Escrever os números por extenso quando a voz deve dizê-los ("number one", não "#1": a referência pronunciou "hashtag one").
  • Sem símbolos, abreviações ou parênteses no roteiro; nomes próprios difíceis recebem uma grafia fonética em comentário.

4. O slideshow (resumo; detalhe em references/visual-pipeline.md)

Medido em dois vídeos completos: 297 e 323 imagens fixas, 4,1 a 4,8 s por imagem, uma imagem por frase, cortes secos, zero transição, zero movimento de câmera, 94% do tempo estritamente fixo. O ritmo vem da edição e da voz, não da animação.

Cinco famílias de planos, a misturar: ícone + 1 a 3 palavras (35%), cena com personagem (25%), esquema ou comparação (22%), gráfico de dados (10%), cartão-título (5%). Estilo único: fundo creme, traço fino preto, pastéis, letras manuscritas em maiúsculas, personagens com cabeça redonda branca. Um motivo visual recorrente (a cena de abertura) retorna no meio e no final.

5. Controle de qualidade antes da entrega

  • Tópico validado pelo teste do espelho; título no formato "Why [força] [verbo] [traço] ([negação])"
  • Abertura = cena física em segunda pessoa, em menos de 170 palavras
  • Promessa de um twist na parte 2, cumprida na parte 6
  • 3 a 5 cientistas nomeados com instituição, ano, número; todos verificados
  • 40 a 90 números; uma analogia por conceito; 2 "you" para 100 palavras
  • CTA integrado por volta dos 60%, relacionado ao tópico, seguido de retomada
  • Virada "trade-off" depois retorno à cena de abertura e pergunta aos comentários
  • 3.300 a 3.600 palavras; 8 a 11 capítulos nomeados "The … of …"
  • Lista de imagens: uma por frase, família indicada, prompt completo; números na tela idênticos aos da voz
  • Nenhum rótulo de imagem que descreve a imagem em vez de nomear a coisa ("LARGE CALM CLOCK FACE" é um erro da referência)
  • Roteiro sem símbolos ou abreviações para a voz de IA
  • Ficha de publicação completa (§0 de publication-seo.md): categoria Educação escrita, tags ≤ 500 caracteres verificados, capítulos nos tempos reais da voz, conteúdo sintético = sim, comentário para fixar
  • Imagens: prancha de contato verificada pelo agente QC de imagens (nenhuma bolha de diálogo, nenhum texto gerado, mesmo personagem em todas), rejeições regeneradas; nenhum cartão de número sem ícone; nunca 3 imagens da mesma família seguidas; miniatura 1280 × 720 com texto por código

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas