🎬 Skill video-explicativo — Vídeos explicativos com Claude Code

Repositório da Skill video-explicativo (Claude Code) + o curso completo no formato INEMA.CLUB que ensina a usá-la. A Skill cria vídeos explicativos narrados (HTML → MP4) com o framework HyperFrames — animados, em PT-BR, renderizados localmente, sem chave de API, nos formatos 16:9 (YouTube) e 9:16 (Shorts/Reels).

Este projeto nasceu de um vídeo que foi, ele mesmo, feito por uma Skill.

Versão da Skill: v1.10.3 · esquema v1.yy.xxx (yy = recurso, xxx = bug) · histórico em skill/video-explicativo/CHANGELOG.md.

---

📦 A Skill

A Skill video-explicativo está incluída neste repositório:

• Pasta navegável: skill/video-explicativo/
• Download (.zip): downloads/video-explicativo.zip

Instalação

Copie a pasta da skill para um dos diretórios que o Claude Code lê:

# Global (vale para todos os projetos)
cp -r skill/video-explicativo ~/.claude/skills/

# OU por projeto
cp -r skill/video-explicativo .claude/skills/

Ou baixe e descompacte o .zip:

unzip downloads/video-explicativo.zip -d ~/.claude/skills/

Como usar

Depois de instalada, basta pedir um vídeo ao Claude Code em linguagem natural:

“faça um vídeo explicativo sobre X, em 16:9 e 9:16, terminando com a CTA do INEMA.CLUB.”

A Skill dispara automaticamente em pedidos como “fazer um vídeo”, “vídeo explicativo”, “vídeo sobre X”, “vídeo pra Shorts/Reels”, “mini tutorial em vídeo” ou “vídeo do INEMA”.

Pré-requisitos

Roda 100% local, sem chave de API. Você precisa de:

• Node 22+ e FFmpeg (no git-bash, use ffmpeg -nostdin).
• Chrome headless do HyperFrames: npx hyperframes browser ensure.
• Voz bella (inemavox): narração via inemavox/tts_direct.py (--engine chatterbox-vc, ref bella.wav). Fallback Kokoro (pip install kokoro-onnx soundfile, voz pf_dora) só se o inemavox falhar.
• Diagnóstico: npx hyperframes doctor.

O que a Skill faz (pipeline HTML → MP4)

1. Plano de cenas — o nº de cenas sai do assunto, não é fixo: cada beat do arco vira uma cena (range 4–12 + CTA). Default ~1:40–2:00; se o usuário fixar o número, ele manda.
2. Roteiro — SCRIPT.md com as cenas do plano, do primeiro princípio ao avançado, narração curta por cena.
3. Projeto — npx hyperframes init + house style dark premium.
4. Fontes — baixa .woff2 locais (Sora / Inter / JetBrains Mono).
5. Narração — gera os WAVs por cena com a voz bella (inemavox); Kokoro pf_dora é fallback.