media-use: Antes de obter áudio/imagens, chame
/media-usepara resolver BGM/SFX/images do catálogo da HeyGen. Execute--adoptprimeiro para registrar ativos existentes. Veja a skill/media-use.
O que Lançamento de Produto para HyperFrames faz?
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 etapa, verifique seu portão e só então prossiga para a próxima etapa. Esta skill é para um produto que está sendo comercializado, lançado, promovido ou revelado, incluindo solicitações como "promo para nosso site" quando o objetivo é promocional. Encaminhe outras intenções para outro lugar: um tour geral de site não relacionado a lançamento ->
/website-to-video; um explicador de tópico sem produto ->/faceless-explainer; um PR do GitHub ->/pr-to-video; legendas em filmagens existentes ->/embedded-captions; um motion graphic curto sem narração ->/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 as etapas em ordem e passe cada portão antes de continuar. As etapas com portão de usuário são Passo 0, Passo 3 e Passo 6. Faça cada etapa 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 frame-worker, no diretório local ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/ desta skill e em hyperframes-creative.
Fluxo de trabalho: Passo 0 configuração -> hyperframes.json; Passo 1 captura -> capture/; Passo 2 sistema de design -> frame.md; Passo 3 storyboard/roteiro -> 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 ausente. Nomeie <project> a partir da marca ou domínio em kebab-case, como acme-promo; nunca use o nome do workspace 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 transmita sua saída literalmente (não parafraseie ou reescreva). Ele informa se a voz/BGM usará mecanismos HeyGen ou locais e, quando não estiver logado, como fazer login. Se não estiver logado, PARE e aguarde a escolha do usuário — fazer login, ou dizer "go"/"offline" para continuar com mecanismos locais — antes de perguntar sobre o briefing ou qualquer outra coisa. Trate como um ponto de decisão real, não uma nota passageira; não incorpore 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 fixados; o status de login foi mostrado (logado ou continuando offline).
Passo 1: Capturar Ativos
Objetivo: Coletar o material de origem, sinais da marca e ativos utilizáveis para o vídeo.
Classifique a entrada e escolha o caminho. URL explícita -> capture-a e use o site para narração e ativos. Roteiro/briefing colado -> salve literalmente como user_script.txt, pergunte uma vez "usar literalmente ou reestruturar?", armazene a resposta como VO_MODE, depois resolva o destino da captura: URL no texto -> use-a; apenas nome da marca -> WebSearch, confirme a URL em uma linha, depois 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 adiciona automaticamente legendas aos ativos 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 title/description a partir do briefing quando possível. visible-text.txt contém o briefing ou roteiro completo. asset-descriptions.md deve dizer que nenhum ativo foi capturado, a menos que o usuário tenha fornecido notas de ativos.
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 ativos. Se estiver ausente após a captura real, pare e relate captura incompleta. Se capture/BLOCKED.md existir, siga-o.
Passo 2: Sistema de Design
Objetivo: Escolher um preset de quadro fornecido; um script o transforma no frame.md + skin de legenda deste vídeo.
Você faz o único julgamento — qual preset. Leia ../hyperframes-creative/references/design-spec.md e escolha o preset cuja aparência melhor se adapta à marca e ao briefing. Em seguida, execute:
node <SKILL_DIR>/scripts/build-frame.mjs --preset <name> --hyperframes .
O script faz o resto deterministicamente: copia o FRAME.md do preset para frame.md e remixa nos tokens da marca em capture/extracted/tokens.json (cores da marca mapeadas nas chaves de cores do preset por função — tinta, tela, acentos — mantendo chaves/estrutura/componentes; as fontes de exibição + corpo do preset são 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 a próxima etapa 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); 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 um preset nomeado, e (quando o preset fornece um) .hyperframes/caption-skin.html existe como a fonte da skin de legenda.
Passo 3: Storyboard e Roteiro
Objetivo: Transformar o briefing e o material capturado em um plano de história aprovado, quadro a quadro.
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 o blueprint da história, gancho, lógica de persuasão, batidas, VO_MODE e escolhas de ativos. Como um guia flexível, consulte o menu função→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 os 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 ativos, a menos que esse inventário esteja ausente ou inutilizável. Use os campos exatos exigidos das referências de storyboard e roteiro.
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 eles desejam uma prévia ao vivo do esqueleto do storyboard (npx hyperframes preview) — abra-o apenas com um 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, temporização de palavras, música e metadados de áudio a partir do roteiro aprovado.
Inicie o áudio após a aprovação do Passo 3. Execute-o em segundo plano e depois 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, temporização de palavras, consulta BGM da biblioteca de música da HeyGen e metadados de temporização. O clima do BGM vem do campo music: do storyboard. Isso usa a API de Áudio da HeyGen para recuperação, não para geração, e usa a mesma credencial ~/.heygen que 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 clima de música.
Portão: o trabalho de áudio foi iniciado 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 codificada por tempo, o vocabulário de Layout inline e o bloco ## Video direction exigido). 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 codificada por tempo em STORYBOARD.md de acordo com o método de visual-design.md: escolha o blueprint do quadro (ou componha), instancie-o com o conteúdo DESTE produto e ritme a revelação de cada Cena para a narração, de modo 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 em todo o vídeo.
Não altere história, roteiro, escolhas de ativos, asset_candidates, transition_in ou material de origem capturado. Não escreva HTML nesta etapa.
Prepare ativos nomeados após o design visual estar fixado:
node <SKILL_DIR>/scripts/stage-assets.mjs --storyboard ./STORYBOARD.md --hyperframes .
Portão: cada quadro visual tem uma sequência de tomadas codificada por tempo cujas revelações são ritmadas para a narração (sem carregamento no início); ## Video direction existe; assets/ contém os ativos 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 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 de 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 de regra local (../hyperframes-animation/rules/<id>.md) para cada movimento citado e o template do blueprint do quadro (../hyperframes-animation/blueprints/<id>.md). Cada worker escreve apenas compositions/frames/NN-*.html. Workers nunca devem editar STORYBOARD.md.
Assim que cada worker retorna, o orquestrador marca esse quadro como animated em STORYBOARD.md.
Após as temporizações de áudio existirem, construa 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, renderiza o pill padrão embutido. captions: skipped (<reason>) é válido. Continue sem legendas quando explicitamente pulado.
Portão: cada quadro está marcado como animated, index.html existe e as legendas sã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.
Injete transições, execute verificações, pause para revisão e depois renderize.
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, siga em frente — não demore aqui.
Se um comando falhar, exiba stderr e pare — não acumule comandos de recuperação. Conserte você mesmo: a edição segura mais barata em compositions/frames/NN-*.html e, em seguida, reexecute 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á está revisando no Studio.
Prévia: npx hyperframes preview
Renderize