Communitygithub.com

C4KEBX/motionexplainers

Use quando o usuário pedir para criar, roteirizar ou produzir um vídeo explicativo animado vertical de 60 segundos sobre finanças, investimentos ou história neste repositório (

O que é motionexplainers?

Esta skill transforma um tópico em um vídeo explicativo animado vertical completo (1080x1920) de 60 segundos, operando inteiramente dentro do repositório. Ela não requer custos de API; o agente AI realiza a pesquisa, redação e correção, enquanto scripts validam e renderizam o resultado. A skill impõe regras rigorosas de precisão factual: todo número, data ou citação na tela deve vir de um fato em `facts.json` cuja fonte foi efetivamente aberta com WebFetch, proibindo o uso de memória. O fluxo de trabalho inclui sete etapas: briefing, pesquisa com verificação de fontes primárias, validação automática dos fatos, roteirização e storyboard, verificação e reparo, um portal de revisão humano obrigatório (onde o agente para e aguarda aprovação) e, finalmente, a produção do vídeo com narração Edge TTS. A skill é voltada para conteúdos educacionais e históricos sobre finanças e investimentos, sem oferecer conselhos ou previsões, e suporta plataformas como Claude Code, Cursor e Codex que executam comandos npm e npm run.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/C4KEBX/motionexplainers/tree/HEAD/.claude/skills/make-explainer

Perguntar na sua IA favorita

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

Documentação

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.json cuja 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 produce até 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/.

  1. 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úsica null.
  2. 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), value para um número ou dataset para os dados exatos que um gráfico ou lista mostrará, e source com nome e url. Nunca deixe redação de "dados de demonstração" em uma afirmação.
  3. Verificar. npm run verify-facts -- --facts videos/<slug>/facts.json --out videos/<slug>/verify.json. Para cada not-found, partial ou unreachable: 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ão supported prova pouco para ele: leia a linha da fonte você mesmo. Após editar facts.json por qualquer motivo, execute verify-facts novamente; a folha de revisão marca um resultado desatualizado.
  4. 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.json para os campos e limites exatos e copie a estrutura de fixtures/finance.storyboard.json, fixtures/history.storyboard.json e fixtures/ancient.storyboard.json. Escreva videos/<slug>/storyboard.json.
  5. 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.
  6. 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 abrir videos/<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.
  7. 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, execute check novamente, 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.md para 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 produce precisa de internet para Edge TTS; --voice standin dá áudio placeholder quase silencioso apenas para um teste a seco.
  • Configuração ausente: execute npm install e npm run setup:tts uma 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ê.

Habilidades Relacionadas