Instalação do plugin: Antes dos comandos de configuração ou atualização, siga as regras de execução do plugin quando esta skill estiver dentro de um plugin HyperFrames. Instalações independentes mantêm as instruções de atualização abaixo.
Primeiro, mantenha esta skill atualizada — confirme com o usuário antes de executar:
npx hyperframes skills update faceless-explainer. Uma operação rápida e inócua quando tudo está atualizado; caso contrário, ela atualiza esta skill e as skills de domínio principal das quais depende, antes que você as utilize.
media-use: Antes de obter áudio/imagens/logos, execute
/media-usepara resolver BGM/efeitos sonoros/imagens do catálogo do HeyGen e logotipos de suas fontes oficiais. Execute--adoptprimeiro para registrar ativos existentes. Veja a skill/media-use. Quando o aplicativo host fornecer suas próprias ferramentas de música ou efeitos sonoros, use-as para música e efeitos sonoros.
Criador de Vídeos Explicativos Sem Rosto para HyperFrames
Use esta skill para transformar um corpo de texto em um vídeo explicativo: escolha um sistema de design, planeje uma história educativa e construa quadro a quadro no HyperFrames. Sem rosto significa que cada visual é inventado posteriormente — não há etapa de captura e nenhum inventário de ativos reais.
A porta de entrada é
/hyperframes. Você é o orquestrador. Execute cada etapa, verifique sua porta, e só então prossiga. Esta skill é para explicar um tópico a partir de texto, sem produto e sem site para capturar. Qualquer outra intenção, um simples "fazer um vídeo" ou qualquer incerteza → leia/hyperframesprimeiro — a camada de intenção é dona de toda decisão de rota, e uma criação nova que chega aqui semBRIEF.mdpassa por ela de qualquer forma (regra de abertura da Configuração).
Você é o orquestrador. Trabalhe em videos/<projeto>/. Execute as etapas em ordem e passe cada porta antes de continuar. As etapas com porta do usuário são Etapa 0, Etapa 3 e Etapa 6. Leia ../hyperframes/references/brief-contract.md antes da Etapa 0 — ela define os tipos de porta e como fluxo/storyboard do BRIEF.md derivam o modo que governa as portas das Etapas 3/4/6. Faça você mesmo cada etapa, exceto a Etapa 5, onde você despacha um sub-agente por quadro. Não coloque regras de design ou movimento aqui; elas residem no sub-agente de trabalho do quadro, no ../hyperframes-animation/rules/ local desta skill + ../hyperframes-animation/blueprints/ e hyperframes-creative.
Fluxo de trabalho: Etapa 0 configuração → hyperframes.json; Etapa 1 brief → capture/extracted/; Etapa 2 sistema de design → frame.md; Etapa 3 storyboard/roteiro → STORYBOARD.md e SCRIPT.md; Etapa 3.1 áudio → audio_meta.json; Etapa 4 design visual → STORYBOARD.md enriquecido; Etapa 5 quadros → compositions/frames/NN-*.html e index.html; Etapa 6 renderização final → renders/video.mp4.
Etapa 0: Configuração
Objetivo: Entrar com um brief confirmado, criar o projeto HyperFrames e tornar o brief durável.
O brief é confirmado pela camada de intenção, não por perguntas feitas aqui. Regra de abertura, em ordem: (1) BRIEF.md existe → leia-o e não pergunte nada — o brief está resolvido, e seu fluxo/storyboard deriva o modo (contrato de brief § 1). (2) Sem BRIEF.md mas o projeto existe (hyperframes.json / STORYBOARD.md no disco) → retome a partir do frontmatter do storyboard e das preferências registradas; nunca reinterrogue um projeto meio construído. (3) Nenhum dos dois — uma solicitação de criação nova que chegou aqui diretamente → leia /hyperframes e execute sua camada de intenção (references/intent-interview.md): ela verifica receitas e padrões lembrados, conduz as perguntas desta rota (../hyperframes/references/routes/faceless-explainer.md), e entrega o brief bloqueado. Solicitações de edição pulam tudo isso — vá fazer a edição.
Inicialize apenas se hyperframes.json estiver faltando. Nomeie <projeto> a partir do tópico em kebab-case, como juros-compostos-explicados; nunca use nome do espaço de trabalho ou timestamp.
npx hyperframes init "videos/<projeto>" --non-interactive --example=blank --skill=faceless-explainer — init verifica as skills instaladas em relação às mais recentes no GitHub e atualiza o conjunto global se alguma estiver desatualizada.
Após a inicialização, defina <RAIZ_DO_PROJETO> como videos/<projeto> e execute todos os comandos de caminho relativo subsequentes com esse diretório como diretório de trabalho. Nos comandos abaixo, . significa <RAIZ_DO_PROJETO>; nunca escreva .media, capture ou arquivos de saída no diretório do chamador.
Escreva BRIEF.md imediatamente após a inicialização (nunca antes — init recusa um diretório não vazio): o brief bloqueado da camada de intenção, formato conforme ../hyperframes/references/brief-format.md. Resolva <DIR_DE_MIDIA> como o diretório da skill /media-use instalada. Em seguida, registre cada resposta baseada em preferência com node <DIR_DE_MIDIA>/scripts/prefs.mjs record --hyperframes . (brief-format.md nomeia o subconjunto). Se a camada de intenção adotou uma receita, execute node <DIR_DE_MIDIA>/scripts/recipe.mjs use --hyperframes . --name <nome>; ela copia seu frame.md para o projeto (a Etapa 2 é então pulada) e retorna os esboços que a Etapa 3 redige. Uma receita preenche respostas, não aprovações; as portas de revisão ainda são executadas.
Mostre o status de login antes de prosseguir além da Configuração — execute npx hyperframes auth status e repita sua saída literalmente. Ele informa se voz/BGM usará HeyGen ou mecanismos locais e, quando desconectado, como fazer login. Aplique uma ramificação:
- Colaborativo: aguarde o usuário fazer login ou escolher explicitamente
offline/ir. - Autônomo: declare o status e continue pelos mecanismos locais disponíveis.
Não omita silenciosamente uma capacidade necessária quando não houver provedor offline; exiba o bloqueador. Não coloque esta decisão em outra pergunta nem escreva chaves em um .env por repositório. Propriedade de autenticação e fallbacks offline: /media-use references/setup-providers.md § Provedores.
Porta: hyperframes.json e BRIEF.md existem; as respostas baseadas em preferência foram registradas (contrato de brief § 2); o status de login foi mostrado (conectado ou continuando offline).
Etapa 1: Brief (sem captura)
Objetivo: Incorporar o texto do usuário no projeto como fonte de informação. Não há captura de site e nenhum ativo real — este é um explicador sem rosto.
Salve a entrada completa do usuário literalmente, depois crie o pacote de captura sintético manualmente:
capture/extracted/visible-text.txt— o artigo completo / anotações / tópico / resumo, literalmente. Esta é a fonte de informação, não um modelo de história (a Etapa 3 o remodela).capture/extracted/tokens.json—{ "title": "", "description": "", "colors": [], "fonts": [] }. Preenchatitle/descriptiona partir do brief. Deixecolors/fontsvazios, a menos que o usuário tenha fornecido explicitamente cores ou fontes da marca — então adicione-as (o preset de design fornece uma paleta completa independentemente).
Se o usuário colou um roteiro ou deseja manter suas palavras, salve-o literalmente como user_script.txt; MODO_VOZ (literal ou reestruturado) vem de BRIEF.md — a camada de intenção pergunta quando um roteiro chega. Pergunte uma vez aqui apenas se o brief de alguma forma não tiver isso e armazene a resposta para a Etapa 3.
Não execute npx hyperframes capture (não há URL). Não crie asset-descriptions.md nem preencha capture/assets/ — os visuais sem rosto são inventados nas Etapas 4-5, não capturados. A única exceção: se o usuário forneceu uma imagem real, coloque-a em public/<nome_base> e anote-a para a Etapa 3.
Porta: capture/extracted/visible-text.txt e capture/extracted/tokens.json existem; você pode declarar o tópico e o público do explicador em uma frase clara.
Etapa 2: Sistema de Design
Objetivo: Escolher um preset de quadro fornecido; um script o transforma no frame.md deste vídeo + skin de legenda.
Quando BRIEF.md nomeia um style_preset — o usuário o escolheu visualmente nas vitrines da camada de intenção — use-o; o julgamento é seu apenas quando o brief está silencioso. Então você faz a única chamada — qual preset: leia ../hyperframes-creative/references/design-spec.md e navegue por ../hyperframes-creative/frame-presets/; escolha o preset cuja aparência melhor se adequa ao tópico, tom e público. Em seguida, execute:
node <DIR_DA_SKILL>/scripts/build-frame.mjs --preset <nome> --hyperframes .
O script faz o resto deterministicamente: copia o FRAME.md do preset → frame.md e remixa quaisquer tokens de marca em capture/extracted/tokens.json (cores da marca mapeadas nas chaves de cor do preset por função; as fontes de exibição + corpo do preset trocadas pelas da marca), copia a skin de legenda do preset para .hyperframes/caption-skin.html e autovalida (sai com 1 em mapeamento quebrado). Prossiga assim que ele sair com 0 — sem edição manual da especificação.
Um explicador sem rosto geralmente não tem cores/fontes de marca (tokens.json colors/fonts vazio) → o script mantém a própria paleta do preset, um design completo e pronto para uso. Apenas quando o usuário nomeou cores/fontes da marca, adicione-as ao tokens.json antes de executar, e apenas ajuste frame.md manualmente depois se um mapeamento realmente precisar.
Porta: build-frame.mjs saiu com 0 — frame.md existe de um preset nomeado, e (quando o preset fornece um) .hyperframes/caption-skin.html existe como a fonte da skin de legenda; o preset escolhido foi registrado como preferência (--key style_preset --workflow <este fluxo de trabalho>, contrato de brief § 2).
Etapa 3: Storyboard e Roteiro
Objetivo: Transformar o texto em um plano de ensino quadro a quadro aprovado.
Leia ../hyperframes-creative/references/story-spine.md (linguagem de gancho, valor antes da evidência, storyboard como proposta, visuais rastreáveis à fonte), references/story-design.md, ../hyperframes-animation/blueprints-index.md, ../hyperframes/references/storyboard-format.md e ../hyperframes/references/script-format.md. Use-os para escrever STORYBOARD.md e, quando for necessária narração, SCRIPT.md. Defina duration: no frontmatter a partir do length do brief — uma expectativa aproximada; o relatório de montagem informa onde o corte se alinha em relação a ela.
Use story-design.md para a estrutura do explicador (conceito / como-fazer / lista / história), estratégia de gancho, técnicas de clareza, batidas emocionais, o mapeamento de enumeração de tipo e MODO_VOZ. 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. Como um guia suave, consulte o menu de papel→blueprint em ../hyperframes-animation/blueprints-index.md: para cada batida, escreva a narração na forma que seu blueprint candidato implica e marque esse candidato blueprint: id quando couber. A verdade do ensino ainda decide quais batidas existem — nunca force uma batida a se encaixar em um blueprint e nunca invente uma batida apenas porque uma forma comprovada está disponível. Os visuais sem rosto são inventados posteriormente, então os quadros não carregam um inventário de ativos: deixe asset_candidates vazio, a menos que o usuário tenha fornecido uma imagem real public/<nome_base>. Use os campos exatos exigidos das referências de storyboard e roteiro.
Após rascunhar, execute a passagem de plano do loop de revisão — ../hyperframes/references/review-loop.md § 1: apresente o plano como uma proposta e faça as duas perguntas — aprovar ou alterar, e esboços primeiro (recomendado) ou pular. O feedback chega como uma resposta de chat; repita até aprovação. Esta é uma porta de ponto de verificação (contrato de brief § 1): no modo autônomo não há o que perguntar — publique o mesmo resumo como um aviso e prossiga; os esboços são incorporados à construção, e a prévia final com sua única pergunta vem na Etapa 6.
Porta: STORYBOARD.md existe, cada quadro tem os campos narrativos necessários, SCRIPT.md existe quando a narração é necessária, e o usuário aprovou o plano quadro a quadro (autônomo: o resumo foi postado como um aviso).
Etapa 3.1: Áudio
Objetivo: Gerar narração, temporização de palavras, música e metadados de áudio a partir do roteiro aprovado.
Inicie o áudio após a aprovação da Etapa 3. Execute-o em segundo plano e depois continue para a Etapa 4. (O status de login já foi mostrado na Etapa 0; o mecanismo recai automaticamente.)
Escolha a voz de narração a partir da solicitação do usuário antes de invocar. Se a solicitação nomeou uma voz, gênero ou tom, escolha um id de voz correspondente e passe-o com --voice <id>. O padrão do pipeline é Marcia (feminino) no HeyGen / am_michael no Kokoro — então uma solicitação como "uma voz masculina" é silenciosamente ignorada, a menos que você passe a flag. Os ids de voz são específicos do provedor; resolva contra o provedor que o status de login da Etapa 0 selecionou: HeyGen (conectado) via node <DIR_DE_MIDIA>/audio/scripts/heygen-tts.mjs --list (ou GET /v3/voices?engine=starfish); Kokoro (offline) via a tabela de vozes em <DIR_DE_MIDIA>/audio/references/tts.md (prefixos am_/bm_ masculino, af_/bf_ feminino). Quando o usuário não expressou preferência, recorra à voz lembrada (contrato de brief § 2) antes do padrão do pipeline e diga qual você usou; omita --voice apenas quando nenhum nomear uma. Quando o usuário escolheu explicitamente uma voz nesta execução, registre-a (prefs.mjs record --key voice).
node <DIR_DA_SKILL>/scripts/audio.mjs --script ./SCRIPT.md --storyboard ./STORYBOARD.md --hyperframes . --out ./audio_meta.json --voice <id-da-voz> &
O script de áudio lida com narração, temporização de palavras, pesquisa de BGM na biblioteca de música do HeyGen e metadados de temporização. O humor do BGM vem do campo music: do storyboard. Isso usa a API de Áudio do HeyGen para recuperação, não geração, e a mesma credencial ~/.heygen que o TTS. Para detalhes do provedor, leia ../media-use/audio/references/tts.md. Quando as próprias ferramentas do aplicativo host criam a música ou um efeito sonoro, coloque o arquivo em assets/ e liste-o no arquivo audio_meta.json marcado "source": "host": música como bgm { "path": "assets/…", "source": "host" } com music: none no storyboard; um som como uma entrada sfx { "frame": <n>, "file": "assets/…", "offset_s": 0, "duration_s": <sua duração>, "source": "host" }. Cada passagem de áudio mantém esses, e um quadro com som do host não recebe dica pesquisada.
Se não houver narração e nenhum SCRIPT.md, pule a geração de voz. O BGM ainda pode ser executado se o storyboard tiver um humor musical.
O marcador canônico de silêncio completo (compartilhado entre os fluxos de trabalho que reutilizam este modelo de áudio): music: none no bloco YAML superior do STORYBOARD.md, sem SCRIPT.md e sem dicas sfx: ou áudio do host. Essa combinação marca o projeto como silencioso — nenhuma passagem de áudio é executada (audiometa.md vazio, nenhum arquivo de saída do TTS ou da biblioteca de música). A Etapa 3.1 é formalmente ignorada; pulamos para a Etapa 4.
[truncado para tradução]
...
[truncado para tradução]
Porta: O processo audio.mjs saiu — ./audio_meta.json existe com a estrutura exigida; sem SCRIPT.md e com music: none, silêncio completo foi confirmado e a Etapa 3.1 é ignorada.
Etapa 4: Design Visual
Objetivo: Aplicar o sistema de design escolhido a cada quadro do storyboard.
Leia ../hyperframes-creative/references/visual-design.md e o frame.md do projeto. Para cada quadro em STORYBOARD.md, enriqueça-o com especificações de design visual: layout, tipografia, paleta de cores, animações e quaisquer gráficos ou diagramas. Use os blueprints de ../hyperframes-animation/blueprints/ como ponto de partida, adaptando-os ao conteúdo do quadro.
O resultado é um STORYBOARD.md enriquecido que serve como especificação completa para a geração dos quadros na Etapa 5.
Porta: STORYBOARD.md enriquecido existe com especificações visuais para cada quadro.
Etapa 5: Quadros
Objetivo: Gerar arquivos HTML para cada quadro e uma página de índice.
Para cada quadro no storyboard enriquecido, crie um arquivo HTML em compositions/frames/NN-*.html, onde NN é o número do quadro (ex.: 01-introducao.html). Cada arquivo HTML deve ser autossuficiente, incorporando CSS e JavaScript conforme necessário, e deve representar fielmente o design visual especificado na Etapa 4.
Além disso, crie um compositions/index.html que sirva como uma galeria navegável de todos os quadros, permitindo a pré-visualização da sequência.
Nota: Esta etapa é a única onde você despacha sub-agentes — um para cada quadro — para garantir qualidade e consistência.
Porta: compositions/frames/ contém um arquivo HTML para cada quadro do storyboard; compositions/index.html existe e permite a navegação entre eles.
Etapa 6: Renderização Final
Objetivo: Compilar os quadros e o áudio em um arquivo de vídeo final.
Use as ferramentas de renderização do HyperFrames para compilar os arquivos HTML dos quadros, o áudio (narração e música) e quaisquer metadados de temporização em um vídeo MP4. O comando de renderização lê o hyperframes.json, o STORYBOARD.md enriquecido, o audio_meta.json e os arquivos HTML em compositions/frames/ para produzir renders/video.mp4.
Após a renderização, apresente uma prévia ao usuário e faça a pergunta final: aprovar o vídeo ou solicitar alterações. Esta é uma porta de aprovação do usuário (contrato de brief § 1).
Porta: renders/video.mp4 existe; o usuário aprovou o vídeo final (autônomo: a prévia foi apresentada como um heads-up).
Portas e Modos Resumidos:
| Etapa | Nome | Tipo de Porta |
|---|---|---|
| 0 | Configuração | Usuário |
| 1 | Brief | Verificação |
| 2 | Design | Verificação |
| 3 | Storyboard/Roteiro | Ponto de Verificação |
| 3.1 | Áudio | Verificação |
| 4 | Design Visual | Verificação |
| 5 | Quadros | Verificação |
| 6 | Renderização Final | Usuário |