Communitygithub.com

explicador-em-video

Crie vídeos explicativos verticais (9:16) de 2 a 3 minutos para espectadores não técnicos, apresentados pelo personagem arquiteto cartoon "Hellboy", no estilo dos reels de referência (controle de capítulos, diagramas, legendas com karaokê, personagem com sincronia labial, voz indo-inglesa). Use quando solicitado a criar, roteirizar, storyboardar, renderizar ou melhorar um vídeo explicativo / reel / curta sobre qualquer tópico técnico.

O que é explicador-em-video?

Este skill transforma um único tópico técnico em um vídeo MP4 vertical (1080×1920) de 2 a 3 minutos, totalmente produzido, que uma pessoa não técnica entende de primeira. O estilo visual, ritmo e estrutura do roteiro são clonados de um canal de referência (analisado em `docs/01-style-bible.md`). Duas coisas são deliberadamente originais: o personagem (Hellboy) e a voz. O usuário só precisa escrever arquivos de texto (um roteiro e um `storyboard.json`). O mecanismo em `engine/` cuida da voz, legendas, animação, personagem, música e renderização. O fluxo de trabalho é estruturado em etapas sequenciais: scaffolding, planejamento do roteiro (7 batidas), planejamento visual, escrita do storyboard, validação (deve passar com 0 erros), pré-visualização, renderização e QA final. As regras não negociáveis incluem: Hellboy nunca é redesenhado (vem apenas de `character/hellboy/hellboy.js`), a voz é fixa, o roteiro tem entre 360 e 470 palavras (duração de 2:00 a 2:50), cada sentença muda algo na tela, e o validador deve passar antes da renderização. O script segue uma estrutura de 7 batidas (Gancho → Tensão → Roteiro → Corpo → Reviravolta → Recap → Frase de efeito) com uma receita de cenas que equilibra tipos visuais e aparições do Hellboy em 40–70% das cenas.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bhuvanchandmaddi/video-generator-skill/tree/HEAD/skills/explainer-video

Perguntar na sua IA favorita

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

Documentação

Habilidade de Vídeo Explicativo (Hellboy)

Você transforma um tópico técnico em um MP4 1080×1920 de 2 a 3 minutos que uma pessoa não técnica entende na primeira visualização. O estilo visual, o ritmo e a estrutura do roteiro são clonados de um canal de referência (analisado em docs/01-style-bible.md). Duas coisas são deliberadamente nossas: o personagem (Hellboy) e a voz.

Você só escreve arquivos de texto (um roteiro e um storyboard.json). O mecanismo em engine/ cuida da voz, legendas, animação, personagem, música e renderização.


Quando o usuário fornece apenas um tópico

Faça todo o trabalho sem fazer mais perguntas:

  1. Crie um slug a partir do tópico (como-dns-funciona) e execute python engine/make_video.py new videos/<slug>.
  2. Escreva videos/<slug>/script.md (docs/02) e depois videos/<slug>/storyboard.json (docs/03 + docs/04). Copie padrões de examples/upi-explained/.
  3. Execute python engine/validate_storyboard.py videos/<slug>. Corrija cada ERRO e repita até que imprima 0 error(s).
  4. Execute python engine/make_video.py preview videos/<slug>. Se você conseguir ver imagens, verifique build/preview.png com base na seção B do docs/06 e corrija.
  5. Execute python engine/make_video.py render videos/<slug>. Responda com o caminho output/<slug>.mp4, a duração e um resumo de 2 linhas.

Os itens não negociáveis

  1. Hellboy nunca é redesenhado. Ele vem apenas de character/hellboy/hellboy.js. Você pode definir show, arm (down/point/explain) e expression, nada mais. Leia character/hellboy/CHARACTER_BIBLE.md uma vez.
  2. A voz é fixa em engine/config.json. Não a altere por vídeo.
  3. Duração: 360–470 palavras de narração, 2:00–2:50. Frases com ≤ 20 palavras.
  4. Cada frase muda algo na tela. Os itens aparecem na palavra-chave falada ("at").
  5. Correto supera simples. Simplifique omitindo coisas, nunca dizendo algo falso.
  6. O validador deve passar (0 erros) antes da renderização.

Fluxo de trabalho (faça nesta ordem)

#EtapaLeiaSaída
1Scaffold–python engine/make_video.py new videos/<slug>
2Planejar + escrever o roteirodocs/02-script-writing.mdvideos/<slug>/script.md (360–470 palavras, 7 batidas)
3Planejar os visuaisdocs/03-visual-planning.mdlista de cenas: narração → tipo, título, personagem
4Escrever o storyboarddocs/04-storyboard-reference.mdvideos/<slug>/storyboard.json (ou meta.json + scenes.jsonl → assemble)
5Validar–python engine/validate_storyboard.py videos/<slug> → corrigir até 0 erros
6Pré-visualizar + QAdocs/06-qa-checklist.mdmake_video.py preview videos/<slug> → inspecionar build/preview.png, corrigir
7Renderizardocs/05-production.mdmake_video.py render videos/<slug> → output/<slug>.mp4
8QA finaldocs/06-qa-checklist.mdpontuação ≥ 85, todos os itens OBRIGATÓRIOS aprovados

Modelo pequeno/local? Siga docs/07-small-model-playbook.md em vez das etapas 2–5. Ele divide o trabalho em prompts de uma cena por vez.

O roteiro de 7 batidas (memorize)

Gancho (≤ 22 palavras: "X explicado." / "Como o X realmente funciona?" / afirmação surpreendente / ação relacionável) → Tensão (o mistério) → Roteiro ("Vamos seguir…") → Corpo (3–6 capítulos: conceito → significado simples → exemplo cotidiano → consequência; UM exemplo contínuo com uma pessoa nomeada) → Reviravolta ("Mas aqui está a parte interessante…") → Recap ("Então lembre-se assim." uma linha por capítulo) → Frase de efeito (fragmentos que ecoam o gancho: "Uma varredura. Quatro jogadores. Dois segundos.").

Receita de cena (memorize)

  • 1 cena = 1–3 frases (8–28 palavras, 3–8 s); 20–32 cenas por vídeo.
  • Escolha visual.type da tabela de decisão em docs/03-visual-planning.md. Use 7–12 tipos diferentes por vídeo.
  • Mostre Hellboy em 40–70% das cenas (sempre: primeira cena, reviravolta, recap, última cena). Esconda-o para sequence, hub, diagram, compare.
  • Construa diagramas grandes ao longo de 2–4 cenas com "continue": true + itens "shown": true e o mesmo título.
  • Títulos com 2–6 palavras e uma palavra com acento. Rótulos na tela com 1–4 palavras.

Comandos (a partir da raiz do repositório)

# ative primeiro:  source .venv/bin/activate   |   Windows: .\.venv\Scripts\Activate.ps1
python engine/make_video.py new       videos/<slug>   # modelos
python engine/make_video.py assemble  videos/<slug>   # meta.json + scenes.jsonl -> storyboard.json
python engine/validate_storyboard.py  videos/<slug>   # deve ter 0 erros
python engine/make_video.py preview   videos/<slug>   # build/preview.png (1 quadro por cena)
python engine/make_video.py render    videos/<slug> [--fast]

Primeira vez em uma máquina: ./setup.sh (Linux/macOS) ou setup.ps1 (Windows). Os vídeos finalizados vão para output/<slug>.mp4.

Material de referência

  • examples/upi-explained/ (papel-quente) e examples/load-balancer-explained/ (blueprint) — exemplos completos. Copie seus padrões.
  • templates/ — script.template.md, storyboard.template.json.
  • docs/01-style-bible.md — o que a referência faz, medido (por que as regras existem).
  • engine/icon_names.txt — todos os 2.359 nomes de ícones permitidos (Lucide).

Habilidades Relacionadas