Faça um vídeo explicativo de 60 segundos
Transforme um tópico em um vídeo finalizado 1080x1920 com o pipeline deste repositório. Não custa nada: você faz a pesquisa, a redação e os reparos; os scripts verificam e renderizam. Trabalhe a partir da raiz do repositório. Leia .claude/skills/make-explainer/rules.md antes de escrever um storyboard.
Regras rígidas
- Todo número, data, nome e citação na tela vem de um fato em
facts.jsoncuja fonte você realmente abriu com WebFetch. Nunca digite um número de memória. Se não conseguir referenciar uma afirmação, corte-a. A narração declara apenas o que uma página que você abriu diz; não acrescente informações de fundo que você não leu. - Nunca edite
src/,tests/, os validadores ou esta skill para fazer um storyboard passar. Corrija o storyboard ou os fatos. Nunca altere os dados de um fato para corresponder a um storyboard, ou vice-versa, sem reler a fonte. - PARE no portal de revisão (etapa 6). Não execute
npm run produceaté que o usuário aprove a folha de revisão. - Finanças e investimentos são educacionais e históricos: sem conselhos, sem previsões, sem "você deveria". Nomeie o período e a fonte para cada valor.
Fluxo de trabalho
Tudo para um vídeo fica em videos/<slug>/ (letras minúsculas, dígitos, hífens): facts.json, storyboard.json, review/.
- Briefing. Defina o tópico, uma frase de tese que o vídeo comprova e o público. Faça apenas uma pergunta se a tese não estiver clara. Voz padrão
en-US-AndrewNeural, músicanull. - Pesquisa. WebSearch, depois WebFetch as fontes primárias (BLS, Federal Reserve, SEC, registros de empresas; Wikipedia ou páginas de museus e bibliotecas para datas históricas). Copie os números da página. Escreva de 5 a 8 fatos:
id,claim(uma frase completa com unidades e período, conforme a fonte afirma),valuepara um número oudatasetpara os dados exatos que um gráfico ou lista mostrará, esourcecom nome e url. Nunca deixe redação de "dados de demonstração" em uma afirmação. - Verificar.
npm run verify-facts -- --facts videos/<slug>/facts.json --out videos/<slug>/verify.json. Para cadanot-found,partialouunreachable: reabra a fonte, corrija ou remova o fato. A ferramenta é consultiva; você é responsável pela precisão. Um número inteiro pequeno (8, 9, 27) aparece em quase qualquer página, entãosupportedprova pouco para ele: leia a linha da fonte você mesmo. Após editarfacts.jsonpor qualquer motivo, executeverify-factsnovamente; a folha de revisão marca um resultado desatualizado. - Roteiro e storyboard. Cerca de 155 palavras de narração no total (55 a 60 segundos), 6 a 10 cenas, um gancho na cena 1, uma ideia por cena, tipos de cena variados (nunca três iguais em sequência). Use
storyboard.schema.jsonpara os campos e limites exatos e copie a estrutura defixtures/finance.storyboard.json,fixtures/history.storyboard.jsonefixtures/ancient.storyboard.json. Escrevavideos/<slug>/storyboard.json. - Verificar e reparar.
npm run check -- --storyboard videos/<slug>/storyboard.json --facts videos/<slug>/facts.json. Corrija cada problema (cada mensagem nomeia a cena e a correção) e execute novamente, no máximo 6 rodadas; se algo ainda bloquear, relate exatamente o quê. Trate avisos (comprimento, redação de conselhos, texto não rastreado) como coisas a corrigir ou justificar. A estimativa de comprimento é boa em cerca de 10 por cento (palavras reais por segundo variaram de 2,5 a 3,2), então mire em 55 a 60 s;produceé a autoridade e um comprimento rejeitado significa apenas ajustar a narração e executar novamente. - Portal de revisão.
npm run sheet -- --storyboard videos/<slug>/storyboard.json --facts videos/<slug>/facts.json --verify videos/<slug>/verify.json --out videos/<slug>/review. Diga ao usuário para abrirvideos/<slug>/review/review.html. Resuma: a tese, a lista de cenas, a contagem de palavras e o comprimento estimado, cada fato com sua verificação de fonte e cada aviso. Peça aprovação ou edições. PARE e aguarde. - Produzir. Após aprovação:
npm run produce -- --storyboard videos/<slug>/storyboard.json --facts videos/<slug>/facts.json --out out/<slug>. Leva cerca de dois minutos. Se rejeitar o comprimento ou uma cena for muito curta, altere a narração, executechecknovamente, produza novamente (a voz em áudio é armazenada em cache por texto). Relate o caminho do arquivo, o comprimento e o volume. Diga claramente o que você não julgou: qualidade da voz, pronúncia, ritmo e gosto. Peça ao usuário para assistir.
Quando algo der errado
- Uma mensagem de verificação que você não entende: ela nomeia um id de cena; abra essa cena em
rules.mdpara seus limites. Não adivinhe a correção. - O fato e a cena discordam: reabra a fonte. Corrija o que estiver errado a partir da fonte, nunca copiando um sobre o outro.
- Uma região do mapa não é encontrada: use a grafia do atlas que a mensagem sugerir ("Estados Unidos da América"); as regiões devem sobrepor a caixa de
focus. - Problemas de voz (rede):
npm run produceprecisa de internet para Edge TTS;--voice standindá áudio placeholder quase silencioso apenas para um teste a seco. - Configuração ausente: execute
npm installenpm run setup:ttsuma vez.
Saída para o usuário
Mantenha-a curta: o caminho do arquivo, o que o vídeo afirma, comprimento, volume, os fatos e fontes usados e qualquer aviso que você aceitou e por quê.