media-use: Antes de obter áudio/imagens, chame
/media-usepara resolver BGM/SFX/imagens do catálogo do HeyGen. Execute--adoptprimeiro para registrar assets existentes. Veja/media-useskill.
Product Launch para HyperFrames
Use esta skill para capturar um produto, entender sua marca, planejar um vídeo de lançamento e construí-lo quadro a quadro no HyperFrames.
Confirme a rota antes do Passo 0. Você é o orquestrador. Execute cada passo, verifique seu portão e só então continue para o próximo passo. Esta skill é para um produto sendo comercializado, lançado, promovido ou revelado, incluindo solicitações como "promo para nosso site" quando o propósito é promocional. Roteie outras intenções para outro lugar: um tour geral de site (não lançamento) para
/website-to-video; um explicador de tópico sem produto para/faceless-explainer; um PR do GitHub para/pr-to-video; legendas em filmagens existentes para/embedded-captions; um gráfico em movimento curto e sem narração para/motion-graphics. Se o usuário disser apenas "faça um vídeo" ou a rota for incerta, leia/hyperframesprimeiro.
Você é o orquestrador. Trabalhe em videos/<project>/. Execute os passos em ordem e passe cada portão antes de continuar. Passos com portão do usuário são Passo 0, Passo 3 e Passo 6. Faça cada passo você mesmo, exceto o Passo 5, onde você despacha um subagente por quadro. Não coloque regras de design ou movimento aqui; elas residem no subagente do quadro, nos ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/ e no hyperframes-creative locais desta skill.
Fluxo de trabalho: Passo 0 configuração -> hyperframes.json; Passo 1 captura -> capture/; Passo 2 sistema de design -> frame.md; Passo 3 storyboard/script -> STORYBOARD.md e SCRIPT.md; Passo 3.1 áudio -> audio_meta.json; Passo 4 design visual -> STORYBOARD.md enriquecido; Passo 5 quadros -> compositions/frames/NN-*.html e index.html; Passo 6 renderização final -> renders/video.mp4.
Passo 0: Configuração e Briefing
Objetivo: Fixar o briefing central do vídeo e criar o projeto HyperFrames, se necessário.
Inicialize apenas se hyperframes.json estiver faltando. Nomeie <project> a partir da marca ou domínio em kebab-case, como acme-promo; nunca use nome do espaço de trabalho ou timestamp.
npx hyperframes init "videos/<project>" --non-interactive --example=blank — init verifica as skills instaladas em relação às mais recentes no GitHub e atualiza o conjunto global se alguma estiver desatualizada.
Mostre o status de login antes do briefing — execute npx hyperframes auth status e repasse sua saída literalmente (não parafraseie ou reescreva). Ele informa se voz/BGM usará mecanismos HeyGen ou locais e, quando não estiver logado, como fazer login. Se não estiver logado, PARE e aguarde o usuário escolher — fazer login, ou dizer "go"/"offline" para continuar com mecanismos locais — antes de perguntar o briefing ou qualquer outra coisa. Trate como um ponto de decisão real, não uma nota passageira; não coloque a escolha na pergunta do briefing e não escreva chaves em um .env por repositório. (No modo autônomo, anote o status e continue offline.) Veja ../hyperframes-media → Preflight para a orientação canônica.
Portão: hyperframes.json existe, e ângulo, duração, proporção de aspecto e idioma estão fixos; o status de login foi mostrado (logado ou continuando offline).
Passo 1: Capturar Assets
Objetivo: Coletar o material de origem, sinais da marca e assets utilizáveis para o vídeo.
Classifique a entrada e escolha o caminho. URL explícito -> capture-o e use o site para narração e assets. Script/briefing colado -> salve literalmente como user_script.txt, pergunte uma vez "usar literalmente ou reestruturar?", armazene a resposta como VO_MODE, então resolva o alvo da captura: URL no texto -> use-o; apenas nome da marca -> WebSearch, confirme a URL em uma linha, então rastreie; sem URL/site -> caminho sem captura.
Execute a captura com: npx hyperframes capture "<URL>" -o ./capture
Se GEMINI_API_KEY, GOOGLE_API_KEY ou uma chave OpenRouter existir, a captura legenda automaticamente os assets em capture/extracted/asset-descriptions.md. Isso não é um portão de revisão. Sem uma chave de visão, use o contexto DOM e continue.
Caminho sem captura: crie capture/extracted/tokens.json, capture/extracted/visible-text.txt, capture/extracted/asset-descriptions.md e capture/assets/ manualmente. tokens.json deve ser { "title": "", "description": "", "colors": [], "fonts": [] }; preencha título/descrição do briefing quando possível. visible-text.txt contém o briefing ou script completo. asset-descriptions.md deve dizer que nenhum asset foi capturado, a menos que o usuário tenha fornecido notas de asset.
Portão: capture/extracted/tokens.json, capture/extracted/visible-text.txt, capture/extracted/asset-descriptions.md e capture/assets/ existem; você pode declarar a marca em uma frase clara. Trate asset-descriptions.md como o inventário principal de assets. Se estiver faltando após a captura real, pare e reporte a captura incompleta. Se capture/BLOCKED.md existir, siga-o.
Passo 2: Sistema de Design
Objetivo: Escolher um preset de quadro embarcado; um script transforma isso no frame.md + skin de legenda deste vídeo.
Você faz a única chamada de julgamento — qual preset. Leia ../hyperframes-creative/references/design-spec.md e escolha o preset cuja aparência melhor se adequa à marca e ao briefing. Então execute:
node <SKILL_DIR>/scripts/build-frame.mjs --preset <name> --hyperframes .
O script faz o resto deterministicamente: copia o FRAME.md do preset → frame.md e o remixa nos tokens da marca em capture/extracted/tokens.json (cores da marca mapeadas nas chaves de cor do preset por função — tinta, tela, acentos — mantendo chaves/estrutura/componentes; 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 se autovalida (sai com 1 em um mapeamento quebrado). Prossiga para o próximo passo assim que sair com 0 — sem edição manual da especificação.
tokens.json sem cores/fontes da marca (por exemplo, sem captura) → o script mantém a paleta do próprio preset, um design completo e enviável. Se o briefing nomear cores/fontes da marca que a captura perdeu, adicione-as a capture/extracted/tokens.json antes de executar (ou use o design.md do usuário para preenchê-lo); só ajuste frame.md manualmente depois se um mapeamento realmente precisar.
Portão: build-frame.mjs saiu com 0 — frame.md existe a partir de um preset nomeado e (quando o preset envia um) .hyperframes/caption-skin.html existe como a fonte da skin de legenda.
Passo 3: Storyboard e Script
Objetivo: Transformar o briefing e o material capturado em um plano de história quadro a quadro aprovado.
Leia references/story-design.md, ../hyperframes-animation/blueprints-index.md, ../hyperframes-core/references/storyboard-format.md e ../hyperframes-core/references/script-format.md. Use-os para escrever STORYBOARD.md e, quando a narração for necessária, SCRIPT.md.
Use story-design.md para blueprint da história, gancho, lógica de persuasão, batidas, VO_MODE e escolhas de asset. Como um guia suave, consulte o menu de papel→blueprint em ../hyperframes-animation/blueprints-index.md: para cada batida, anote um id de blueprint candidato quando um se encaixar. A verdade da história 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. Escolha o asset_candidates de cada quadro visual de capture/extracted/asset-descriptions.md (o inventário canônico) — não navegue pelos capture/assets/ brutos. Não peça ao usuário para escolher assets, a menos que esse inventário esteja faltando ou seja inutilizável. Use os campos exatos exigidos das referências de storyboard e script.
Após o rascunho, mostre um resumo quadro a quadro. Nessa mesma mensagem, pergunte ao usuário duas coisas: (a) aprovar ou solicitar alterações e (b) se deseja uma prévia ao vivo do scaffold do storyboard (npx hyperframes preview) — abra-a apenas se for sim. Itere até aprovação e leve a escolha de prévia para o Passo 6.
Portão: STORYBOARD.md existe, cada quadro visual tem asset_candidates, SCRIPT.md existe quando a narração é necessária e o usuário aprovou o plano quadro a quadro.
Passo 3.1: Áudio
Objetivo: Gerar narração, tempos das palavras, música e metadados de áudio a partir do script aprovado.
Comece o áudio após a aprovação do Passo 3. Execute-o em segundo plano e continue para o Passo 4.
node <SKILL_DIR>/scripts/audio.mjs --script ./SCRIPT.md --storyboard ./STORYBOARD.md --hyperframes . --out ./audio_meta.json &
O script de áudio lida com narração, tempos das palavras, consulta de BGM da biblioteca de música do HeyGen e metadados de tempo. O mood do BGM vem do campo music: do storyboard. Isso usa a API de Áudio do HeyGen para recuperação, não geração, e usa a mesma credencial ~/.heygen que o TTS. Para detalhes do provedor, leia ../hyperframes-media/references/tts.md.
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 mood musical.
Portão: o trabalho de áudio começou ou o projeto está marcado como silencioso.
Passo 4: Design Visual do Quadro
Objetivo: Adicionar a direção visual, intenção de layout e escolhas de movimento a cada quadro do storyboard.
Edite STORYBOARD.md no local. Não crie outro storyboard. Use frame.md como fonte da verdade para cor, tipo, sensação de layout e estilo.
Leia references/visual-design.md, ../hyperframes-animation/blueprints-index.md, references/motion-language.md e ../hyperframes-animation/rules-index.md. Use visual-design.md para o método (a sequência de tomadas com código de tempo, o vocabulário de Layout inline e o bloco obrigatório ## Video direction). Use ../hyperframes-animation/blueprints-index.md para escolher a forma de tomada de cada quadro. Use motion-language.md (o vocabulário de movimento + a doutrina de movimento) e ../hyperframes-animation/rules-index.md (nomes de regras válidos) para movimento — não invente nomes de movimento.
Para cada quadro visual, escreva uma sequência de tomadas com código de tempo em STORYBOARD.md de acordo com o método de visual-design.md: escolha o blueprint do quadro (ou compor), instancie-o com o conteúdo DESTE produto e ajuste o ritmo da revelação de cada Cena à narração para que o quadro se desenvolva ao longo de sua duração total em vez de carregar tudo no início e depois congelar. Declare layout e movimento inline por Cena (vocabulários em visual-design.md e motion-language.md). Adicione um bloco ## Video direction para todo o vídeo.
Não mude história, script, escolhas de asset, asset_candidates, transition_in ou material de origem capturado. Não escreva HTML neste passo.
Prepare assets nomeados depois que o design visual estiver fixo:
node <SKILL_DIR>/scripts/stage-assets.mjs --storyboard ./STORYBOARD.md --hyperframes .
Portão: todo quadro visual tem uma sequência de tomadas com código de tempo cujas revelações são ritmadas para a narração (sem carregamento frontal); ## Video direction existe; assets/ contém os assets nomeados.
Passo 5: Construir Quadros
Objetivo: Construir cada quadro do storyboard como uma composição HTML e montar o vídeo reproduzível.
Aguarde o áudio do Passo 3.1 terminar se o áudio foi iniciado. Em seguida, sincronize as durações e busque SFX; pule ambos se silencioso.
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 .
A sincronização de duração é mecânica: a duração real da voz vence; quadros silenciosos mantêm estimativas; nunca edite manualmente durações sincronizadas.
Antes do despacho, leia sub-agents/frame-worker.md e ../hyperframes-core/references/subagent-dispatch.md. Despache um subagente por quadro, em paralelo se possível; caso contrário, execute workers em ondas. Cada worker recebe exatamente um quadro.
Cada contexto de worker deve incluir PROJECT_DIR, frame_id, tamanho da tela, status da legenda e faixa de exclusão se as legendas estiverem ativadas, e RULES_DIR como o caminho absoluto para ../hyperframes-animation/rules/ desta skill. Cada worker lê frame.md, seu próprio bloco ## Frame N de STORYBOARD.md, a receita da regra local (../hyperframes-animation/rules/<id>.md) para cada movimento citado e o modelo do blueprint do quadro (../hyperframes-animation/blueprints/<id>.md). Cada worker escreve apenas compositions/frames/NN-*.html. Workers nunca devem editar STORYBOARD.md.
À medida que cada worker retorna, o orquestrador marca esse quadro como animated em STORYBOARD.md.
Depois que os tempos de áudio existirem, 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 .
captions.mjs usa o .hyperframes/caption-skin.html do projeto (copiado no Passo 2) como a aparência da legenda, injetando tokens da marca de frame.md; sem skin presente, ele renderiza a pílula padrão integrada. captions: skipped (<reason>) é válido. Continue sem legendas quando explicitamente puladas.
Portão: todo quadro está marcado como animated, index.html existe e as legendas estão construídas ou explicitamente puladas.
Passo 6: Finalizar
Objetivo: Verificar o vídeo montado, obter aprovação do usuário e renderizar o MP4 final.
Injetar transições, executar verificações, pausar para revisão e renderizar.
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 validate
npx hyperframes inspect
npx hyperframes snapshot --at <frame-midpoints>
snapshot combina os quadros capturados em uma folha de contato (snapshots/contact-sheet.jpg). Dê uma olhada; se nada estiver obviamente quebrado, prossiga — não demore aqui.
Se um comando falhar, mostre stderr e pare — não acumule comandos de recuperação. Corrija você mesmo: a edição segura mais barata em compositions/frames/NN-*.html e, em seguida, execute novamente a verificação com falha.
Após as verificações passarem, pause para revisão do usuário. O vídeo está montado, visualizável e editável no Studio. Gerencie a prévia apenas uma vez entre o Passo 3 e o Passo 6: abra-a se o usuário pediu antes, ofereça-a se ele recusou antes e não pergunte novamente se ele já estiver revisando no Studio.
Prévia: npx hyperframes preview
Renderizar...
[truncado para tradução]