Visão Geral
Esta skill constrói vídeos explicativos sem apresentador — baseados em narração, sem câmera — como composições HyperFrames. Use-a para explicações de produtos ou conceitos onde a voz sobreposta e os visuais transmitem a mensagem. Ela renderiza o MP4 final a partir de um script que você fornece.
HyperFrames — Explicador Sem Apresentador
Transforme texto arbitrário em um vídeo explicativo: escolha um sistema de design, planeje uma história de ensino e construa quadro a quadro. Sem apresentador significa que cada visual é inventado — não há etapa de captura e nenhum inventário de ativos reais.
Quando Usar
- O usuário quer um explicador de tópico a partir de um artigo, anotações ou resumo
- O usuário quer uma decomposição de conceito (como algo funciona)
- O usuário quer um tutorial ou instrução (sem captura de tela)
- O usuário quer uma lista animada ou lista com animação
- O usuário quer um explicador baseado em dados (gráficos, estatísticas, comparações)
Quando NÃO Usar
- O usuário quer um lançamento de produto (use
hyperframes-product-launch-video) - O usuário quer um vídeo com apresentador falando (use
hyperframes-embedded-captions) - O usuário quer um gráfico em movimento (use
hyperframes-motion-graphics) - O usuário quer capturar um site (use
hyperframes-product-launch-video)
Fluxo de Trabalho
0 · Configuração
npx hyperframes init "videos/<projeto>" --non-interactive --example=blank --skill=faceless-explainer
Escreva BRIEF.md imediatamente após o init (nunca antes — init recusa um diretório não vazio). Registre as preferências com node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes ..
1 · Brief (sem captura)
Salve a entrada completa do usuário literalmente:
capture/extracted/visible-text.txt— o artigo/anotações/tópico/resumo completocapture/extracted/tokens.json—{ "title": "", "description": "", "colors": [], "fonts": [] }
NÃO execute npx hyperframes capture — não há URL. Os visuais sem apresentador são inventados posteriormente.
2 · Sistema de Design
Escolha um preset de quadro cuja aparência se adapte ao tópico, tom e público:
node <SKILL_DIR>/scripts/build-frame.mjs --preset <nome> --hyperframes .
Isso copia o FRAME.md do preset → frame.md e remixa os tokens da marca. Um explicador sem apresentador geralmente não tem cores/fontes de marca → o script mantém a paleta do próprio preset.
3 · Storyboard e Roteiro
Transforme o texto em um plano de ensino quadro a quadro. A sequência do vídeo vem do design narrativo, não da ordem dos parágrafos do texto de entrada — reordene, mescle, omita, comprima.
Escreva STORYBOARD.md e (quando a narração for necessária) SCRIPT.md. Cada quadro precisa de:
focal/roles— os elementos visuais inventados (palavra herói, nó de diagrama, série de dados)blueprint— a forma do plano (dehyperframes-animation/blueprints/)transition_in— como o quadro entra
3.1 · Áudio
node <SKILL_DIR>/scripts/audio.mjs --script ./SCRIPT.md --storyboard ./STORYBOARD.md --hyperframes . --out ./audio_meta.json --voice <id-voz> &
Voz padrão do pipeline: Marcia (feminina) no HeyGen / am_michael no Kokoro. O clima da música de fundo vem do campo music: no storyboard.
Marcador silencioso canônico: music: none no bloco YAML superior de STORYBOARD.md E nenhum SCRIPT.md = projeto totalmente silencioso.
4 · Design Visual dos Quadros
Para cada quadro, escreva uma sequência de planos com código de tempo:
- Escolha o blueprint do quadro (ou componha)
- Instancie-o com o conteúdo inventado DESTE quadro
- Ajuste a revelação de cada Cena à narração para que o quadro se desenvolva ao longo de sua duração total
Declare layout e movimento embutidos por Cena. Adicione um bloco ## Direção do vídeo para todo o vídeo.
5 · Construir Quadros
Aguarde o término do áudio da Etapa 3.1. Então:
node <SKILL_DIR>/scripts/audio.mjs sync-durations --audio-meta ./audio_meta.json --storyboard ./STORYBOARD.md
node <SKILL_DIR>/scripts/audio.mjs fetch-sfx --storyboard ./STORYBOARD.md --hyperframes .
node <SKILL_DIR>/scripts/frame-packets.mjs --project "$PROJECT_DIR" --storyboard "$PROJECT_DIR/STORYBOARD.md"
Despache um subagente por quadro. Cada trabalhador recebe:
_role.md(a função do trabalhador de quadro)- O pacote daquele quadro (bloco exato do storyboard + corpo do blueprint + receitas de regras citadas, embutidas)
Os trabalhadores escrevem apenas compositions/frames/NN-*.html. Eles nunca editam STORYBOARD.md.
Fundos com sangria total vão em uma camada class="clip", nunca em #root. O chão de um quadro é seu próprio clipe de fundo com duração total.
Construa as legendas em segundo plano e monte o índice:
node <SKILL_DIR>/scripts/captions.mjs build --storyboard ./STORYBOARD.md --audio-meta ./audio_meta.json --hyperframes . --out ./caption_groups.json &
node <SKILL_DIR>/scripts/assemble-index.mjs --storyboard ./STORYBOARD.md --hyperframes .
6 · Finalizar
node <SKILL_DIR>/scripts/transitions.mjs inject --storyboard ./STORYBOARD.md --hyperframes .
node <SKILL_DIR>/scripts/transitions.mjs verify --storyboard ./STORYBOARD.md --index ./index.html
npx hyperframes lint
npx hyperframes check
npx hyperframes snapshot --at <pontos-medios-dos-quadros>
Renderize somente após aprovação do usuário:
npx hyperframes render --skill=faceless-explainer --quality high --output renders/video.mp4
Tabela de Anti-Racionalização
| Racionalização | Realidade |
|---|---|
| "Vou capturar o site do artigo" | Sem apresentador = sem captura. Visuais são inventados, não capturados |
| "Vou usar a ordem dos parágrafos do texto" | O design narrativo decide a sequência, não a ordem da fonte |
| "Vou pular o sistema de design" | frame.md é a fonte da verdade para cor/tipo/layout |
| "Vou colocar todo o conteúdo de uma vez e congelar" | Ajuste as revelações à narração — o quadro se desenvolve ao longo de toda a duração |
| "Vou escrever um blueprint e reutilizá-lo" | Cada quadro escolhe seu próprio blueprint com base no conteúdo |
| "Vou pular o áudio e usar só texto" | O áudio é o relógio — todos os tempos de batida vêm dos timestamps das palavras |
| "Vou adicionar animações de espera entre as revelações" | Cada fase executa — revelações em etapas, câmera com intenção ou UI sequenciada |
| "Vou centralizar a 42% para deixar espaço para legendas" | Legendas são sobreposição — centralize no centro real (y = H/2) |
Verificação
-
hyperframes.jsoneBRIEF.mdexistem -
frame.mdexiste a partir de um preset nomeado -
STORYBOARD.mdexiste com os campos narrativos necessários -
SCRIPT.mdexiste quando a narração é necessária - Trabalho de áudio iniciado ou projeto marcado como silencioso
- Cada quadro tem uma sequência de planos com código de tempo ajustada à narração
- Cada quadro nomeia
focale/ourolesinventados -
index.htmlexiste - Legendas construídas ou explicitamente ignoradas
-
lintecheckpassaram antes da renderização - Usuário aprovou na pausa de revisão