Primeiro, mantenha esta skill atualizada — confirme com o usuário antes de executar:
npx hyperframes skills update faceless-explainer. Um no-op rápido quando tudo está atualizado; caso contrário, atualiza esta skill e as skills do domínio principal das quais ela depende antes de você usá-las.
media-use: Antes de obter áudio/imagens/logotipos, chame
/media-usepara resolver BGM/SFX/imagens do catálogo da HeyGen e logotipos de marca de suas fontes oficiais. Execute--adoptprimeiro para registrar ativos existentes. Veja a skill/media-use.
Faceless Explainer 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 pedagógica e construa quadro a quadro no HyperFrames. Sem rosto significa que todos os visuais são inventados a jusante — 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 seu portão, e só então continue. Esta skill é para explicar um tópico a partir de texto, sem produto e sem site para capturar. Qualquer outra intenção, um simples "criar 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 chegando 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 portão antes de continuar. Etapas com portão de usuário são Etapa 0, Etapa 3 e Etapa 6. Leia ../hyperframes/references/brief-contract.md antes da Etapa 0 — ele define os tipos de portão e como BRIEF.md's flow/storyboard derivam o modo que governa os portões das Etapas 3/4/6. Faça cada etapa você mesmo, exceto a Etapa 5, onde você despacha um subagente por quadro. Não coloque regras de design ou movimento aqui; elas estão no subagente frame-worker, nas regras locais desta skill ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/, e em hyperframes-creative.
Fluxo de trabalho: Etapa 0 configuração → hyperframes.json; Etapa 1 briefing → 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 briefing confirmado, criar o projeto HyperFrames e tornar o briefing durável.
O briefing é confirmado pela camada de intenção, não por perguntas feitas aqui. Regra de abertura, em ordem: (1) BRIEF.md existe → leia e não pergunte nada — o briefing está resolvido, e seu flow/storyboard derivam o modo (contrato de briefing § 1). (2) Não há BRIEF.md mas o projeto existe (hyperframes.json / STORYBOARD.md no disco) → retome do frontmatter do storyboard e das preferências registradas; nunca re-interrogue um projeto meio construído. (3) Nem um nem outro — 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 devolve o briefing 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 workspace 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 o init, defina <RAIZ_DO_PROJETO> como videos/<projeto> e execute cada comando de caminho relativo subsequente 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 o init (nunca antes — init recusa um diretório não vazio): o briefing bloqueado da camada de intenção, formato conforme ../hyperframes/references/brief-format.md. Resolva <DIR_MEDIA> como o diretório da skill /media-use instalada. Em seguida, registre cada resposta baseada em preferência com node <DIR_MEDIA>/scripts/prefs.mjs record --hyperframes . (brief-format.md nomeia o subconjunto). Se a camada de intenção adotou uma receita, execute node <DIR_MEDIA>/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 a partir dos quais a Etapa 3 elabora os rascunhos. Uma receita preenche respostas, não aprovações; os portões de revisão ainda são executados.
Mostre o status de login antes de prosseguir após a Configuração — execute npx hyperframes auth status e transmita sua saída literalmente. Ele informa se a voz/BGM usará HeyGen ou mecanismos locais e, quando desconectado, como fazer login. Aplique um ramo:
- Colaborativo: aguarde o usuário fazer login ou escolher explicitamente
offline/go. - Autônomo: informe o status e continue usando os mecanismos locais disponíveis.
Não omita silenciosamente uma capacidade necessária quando não houver provedor offline; torne o bloqueio visível. Não incorpore esta decisão em outra pergunta ou escreva chaves em um .env por repositório. Propriedade de autenticação e fallbacks offline: /media-use references/setup-providers.md § Provedores.
Portão: hyperframes.json e BRIEF.md existem; as respostas baseadas em preferência foram registradas (contrato de briefing § 2); o status de login foi mostrado (logado, ou continuando offline).
Etapa 1: Briefing (sem captura)
Objetivo: Incorporar o texto do usuário no projeto como fonte de informação. Não há captura de site nem ativos reais — 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 / anotações / tópico / resumo completo, na íntegra. 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 briefing. Deixecolors/fontsvazios a menos que o usuário tenha fornecido explicitamente cores ou fontes de marca — então adicione-as (a predefinição 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; VO_MODE (literal ou reestruturado) vem de BRIEF.md — a camada de intenção pergunta quando um roteiro chega. Pergunte uma vez aqui apenas se o briefing por algum motivo não o tiver, 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 para a Etapa 3.
Portão: 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 uma predefinição de quadro fornecida; um script a transforma no frame.md + skin de legenda deste vídeo.
Quando BRIEF.md nomeia um style_preset — o usuário o escolheu visualmente nas amostras na camada de intenção — use-o; a decisão é sua apenas quando o briefing está silencioso. Em seguida, você faz a única chamada — qual predefinição: leia ../hyperframes-creative/references/design-spec.md e navegue por ../hyperframes-creative/frame-presets/; escolha a predefinição cuja aparência melhor se adapta ao tópico, tom e público. Depois execute:
node <DIR_SKILL>/scripts/build-frame.mjs --preset <nome> --hyperframes .
O script faz o resto deterministicamente: copia o FRAME.md da predefinição → frame.md e o remixa em quaisquer tokens de marca em capture/extracted/tokens.json (cores da marca mapeadas nas chaves de cor da predefinição por função; as fontes de exibição + corpo da predefinição trocadas pelas da marca), copia a skin de legenda da predefinição para .hyperframes/caption-skin.html, e se autovalida (sai com 1 em um mapeamento quebrado). Prossiga assim que 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 vazios) → o script mantém a própria paleta da predefinição, um design completo e enviável. Apenas quando o usuário nomeou cores/fontes de marca, adicione-as a tokens.json antes de executar, e ajuste frame.md manualmente depois apenas se um mapeamento realmente precisar.
Portão: build-frame.mjs saiu com 0 — frame.md existe a partir de uma predefinição nomeada, e (quando a predefinição fornece uma) .hyperframes/caption-skin.html existe como a fonte da skin de legenda; a predefinição escolhida foi registrada como preferência (--key style_preset --workflow <este fluxo>, contrato de briefing § 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 a narração for necessária, SCRIPT.md. Defina o duration: do frontmatter a partir do length do briefing — uma expectativa aproximada; a montagem relata onde o corte cai em relação a ela.
Use story-design.md para a estrutura do explicador (conceito / tutorial / listicle / história), estratégia de gancho, técnicas de clareza, batidas emocionais, o mapeamento enum-tipo e VO_MODE. 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 função→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 com o blueprint: id quando um se encaixar. A verdade pedagógica ainda decide quais batidas existem — nunca force uma batida para caber em um blueprint, e nunca invente uma batida apenas porque uma forma comprovada está disponível. Visuais sem rosto são inventados a jusante, 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 o rascunho, 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; faça o loop até aprovação. Este é um portão de checkpoint (contrato de briefing § 1): no modo autônomo não há nada a perguntar — publique o mesmo resumo como um aviso e prossiga; os esboços são incorporados à construção, e a única pergunta de pré-visualização vem na Etapa 6.
Portão: STORYBOARD.md existe, cada quadro tem os campos narrativos exigidos, SCRIPT.md existe quando a narração é necessária, e o usuário aprovou o plano quadro a quadro (autônomo: o resumo foi publicado como um aviso).
Etapa 3.1: Áudio
Objetivo: Gerar narração, tempos de palavra, 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 faz fallback automaticamente.)
Escolha a voz de narração a partir do pedido 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 (feminina) no HeyGen / am_michael no Kokoro — portanto, uma solicitação como "uma voz masculina" é ignorada silenciosamente a menos que você passe a flag. Os ids de voz são específicos do provedor; resolva em relação a qual provedor o status de login da Etapa 0 selecionou: HeyGen (logado) via node <DIR_MEDIA>/audio/scripts/heygen-tts.mjs --list (ou GET /v3/voices?engine=starfish); Kokoro (offline) via a tabela de vozes em <DIR_MEDIA>/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 briefing § 2) antes do padrão do pipeline, e diga qual você usou; omita --voice apenas quando nenhum dos dois nomear uma. Quando o usuário escolheu explicitamente uma voz nesta execução, registre-a (prefs.mjs record --key voice).
node <DIR_SKILL>/scripts/audio.mjs --script ./SCRIPT.md --storyboard ./STORYBOARD.md --hyperframes . --out ./audio_meta.json --voice <id-voz> &
O script de áudio lida com narração, tempos de palavra, consulta de BGM da biblioteca de música da HeyGen e metadados de tempo. O humor do BGM vem do campo music: do storyboard. Isso usa a API de Áudio da 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.
Se não houver narração e nenhum SCRIPT.md, pule a geração de voz. O BGM ainda pode executar se o storyboard tiver um humor de música.
O marcador canônico de silêncio total (compartilhado entre os fluxos de trabalho que reutilizam este modelo de áudio): music: none no bloco YAML superior de STORYBOARD.md e nenhum SCRIPT.md. Essa combinação marca o projeto como silencioso — sem narração, sem BGM, sem SFX. O audio.mjs reconhece isso e não gera nada (remove qualquer audio_meta.json obsoleto; um audio_meta.json ausente é o que a montagem trata como silencioso), então esta etapa é um pulo limpo. music: none com narração mantém o TTS e desliga apenas o BGM. Use exatamente esta grafia — não improvise outros marcadores.
Portão: o trabalho de áudio começou, ou o projeto foi marcado como silencioso (music: none + nenhum SCRIPT.md).
Etapa 4: Design Visual do Quadro
Objetivo: Adicionar a direção visual, intenção de layout e escolhas de movimento a cada quadro do storyboard.
Esboce a folha de storyboard primeiro (apenas colaborativo). No momento em que o plano é aprovado, execute a passagem de esboço — ../hyperframes/references/review-loop.md § 2 (não espere pela Etapa 3.1; esboços não usam tempos): faça o wireframe de cada quadro você mesmo como uma célula de storyboard.html (`../hyperfram