Primeiro, mantenha essa skill atualizada — execute silenciosamente, não pergunte:
npx hyperframes skills update product-launch-video. Uma operação rápida sem efeito quando tudo está atualizado; caso contrário, atualiza essa skill junto com as skills de domínio central das quais ela depende antes de você confiar nelas.
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. Consulte a skill/media-use.
figma source: Se a origem for uma URL figma.com, execute
/figmaprimeiro — exportação de ativos, tokens de marca e reconstrução de componentes/storyboard, se necessário — e então construa este fluxo de trabalho a partir de sua saída. Não acione o Figma diretamente por meio de ferramentas MCP brutas: isso ignora a sanitização SVG, a proveniência de.media/manifest.jsonle a vinculaçãovar()de token de marca, portanto, uma alteração de marca posterior não pode ser propagada sem uma reimportação completa.
Product Launch to 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.
A porta de entrada é
/hyperframes. Você é o orquestrador. Execute cada etapa, verifique sua porta, 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 propósito é promocional. Um tour pelo site / pedido de demonstração permanece aqui:BRIEF.mdcarrega a intenção de mostrar como está, e as capturas de tela se tornam os ativos que o vídeo apresenta. Qualquer outra intenção, um simples "fazer um vídeo" ou qualquer incerteza → leia/hyperframesprimeiro — a camada de intenção possui todas as decisões de rota, e uma criação nova que chega aqui semBRIEF.mdpassa por ela de qualquer maneira (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 portas controladas pelo usuário são a Etapa 0, a Etapa 3 e a Etapa 6. Leia ../hyperframes-core/references/brief-contract.md antes da Etapa 0 — ela define os tipos de porta e como o fluxo/storyboard de BRIEF.md deriva o modo que rege as portas 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 ficam no subagente trabalhador do quadro, nas ../hyperframes-animation/rules/ locais desta skill + ../hyperframes-animation/blueprints/ e hyperframes-creative.
Fluxo de trabalho: Etapa 0 configuração -> hyperframes.json; Etapa 1 captura -> capture/; Etapa 2 sistema de design -> frame.md; Etapa 3 storyboard/script -> 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-o e não pergunte nada — o briefing está resolvido, e seu fluxo/storyboard deriva 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 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/product-launch-video.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 ausente. Nomeie <projeto> 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/<projeto>" --non-interactive --example=blank --skill=product-launch-video — 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 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 a inicialização (nunca antes — init recusa um diretório não vazio): o briefing bloqueado da camada de intenção, formato conforme ../hyperframes-core/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 esqueletos a partir dos quais a Etapa 3 rascunha. Uma receita preenche respostas, não aprovações; as portas de revisão ainda funcionam.
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á a HeyGen ou mecanismos locais e, quando desconectado, como fazer login. Observe o contrato de código de saída: auth status sai com código 1 quando não está conectado (e quando a credencial armazenada é rejeitada) — essa saída diferente de zero é o estado normal de desconexão, não uma falha de comando, portanto não a trate como erro, não a repita e não a encadeie com &&/set -e de uma forma que abortaria o fluxo de trabalho. Aplique um ramo:
- Colaborativo: aguarde o usuário fazer login ou escolher explicitamente
offline/go. - Autônomo: informe o status e continue através dos mecanismos locais disponíveis.
Não omita silenciosamente uma capacidade necessária quando nenhum provedor offline existir; exiba o bloqueador. Não transforme essa 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 § Providers.
Porta: hyperframes.json e BRIEF.md existem; as respostas baseadas em preferência foram registradas (contrato de briefing § 2); o status de login foi mostrado (conectado ou continuando offline).
Etapa 1: Capturar ativos
Objetivo: Coletar o material de origem, sinais de 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. Script/briefing colado -> salve literalmente como user_script.txt; VO_MODE (literal ou reestruturado) vem de BRIEF.md — a camada de intenção pergunta quando um script chega (pergunte uma vez aqui apenas se o briefing carecer disso). Em seguida, resolva o alvo de captura: URL no texto -> use-a; apenas nome da marca -> WebSearch, confirme a URL em uma linha e rastreie; sem URL/site (ou o briefing diz para não raspar) -> caminho sem captura.
Execute a captura com: npx hyperframes capture "<URL>" -o ./capture --json. Mantenha o orçamento padrão de pós-navegação, a menos que o chamador tenha um prazo menor; então passe um --capture-budget <milissegundos> positivo que deixe tempo para o trabalho downstream. --timeout controla apenas a navegação da página. Use --skip-vision apenas quando a legendagem opcional de imagem estiver intencionalmente desabilitada.
Inspecione o resultado do comando e o diretório de saída imediatamente. Uma saída diferente de zero, JSON ok: false ou capture/BLOCKED.md é uma parada forçada para o caminho de captura: relate o motivo registrado e não consuma capturas de tela parciais, DOM, tokens ou ativos. Não fabrique um fallback sintético de não captura após uma falha de captura de URL. Continue pelo caminho sem captura apenas quando o briefing original forneceu o material de origem, ou quando o usuário explicitamente mudar para uma captura de tela ou briefing fornecidos após a falha.
Avisos como "very little text content" junto com um catálogo de ativos vazio não são prova de uma página utilizável. Para uma visita guiada ao site ou briefing de "mostrar como está", exija uma estrutura capturada confiável ou uma captura de tela fornecida; se nenhum existir, pare. Não invente ou reconstrua a página meramente porque a captura é inutilizável.
Para uma visita guiada ao site ou briefing de "mostrar como está", a página capturada é a fonte visual da verdade. Use a captura de tela real em vez de reconstruir o site completo em HTML. Se a tomada precisar de movimento interno, mantenha a captura de tela como base e sobreponha ativos reais capturados em posições medidas, ou reconstrua apenas o componente que se move. Para uma captura de rolagem, anime a janela de visualização sobre capture/screenshots/full-page.png — a placa 1x do documento inteiro, pixel-perfeita para uma janela de visualização de 1920 de largura percorrendo-o. Ela está ausente quando a página era muito longa para ser capturada em uma peça; recorra às capturas de posição de rolagem sobrepostas no mesmo diretório. Um zoom além de 1:1 requer sua própria captura 2x dessa região, pois a placa não tem espaço acima de 1x. Recrie a página inteira apenas quando o usuário pedir explicitamente uma interpretação estilizada; uma captura inutilizável sozinha não é autorização.
Se GEMINI_API_KEY, GOOGLE_API_KEY ou uma chave OpenRouter existirem, a captura legenda automaticamente os ativos em capture/extracted/asset-descriptions.md. Isso não é uma porta de revisão. Sem uma chave de visão, use o contexto do 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 ativo foi capturado, a menos que o usuário tenha fornecido notas sobre ativos.
Porta: JSON de captura relatou ok: true; capture/BLOCKED.md não existe; capture/extracted/tokens.json, capture/extracted/visible-text.txt, capture/extracted/asset-descriptions.md e capture/assets/ existem; e você pode declarar a marca em uma frase clara. Trate asset-descriptions.md como o inventário principal de ativos. Se ele estiver ausente após a captura real, pare e relate captura incompleta. Avisos sobre uma fase opcional degradada são aceitáveis apenas quando esta porta estrutural ainda passa.
Etapa 2: Sistema de Design
Objetivo: Escolher um preset de quadro enviado; um script o transforma no frame.md + skin de legenda deste vídeo.
Quando BRIEF.md nomeia um style_preset — o usuário o escolheu a olho nos showcases na camada de intenção — use-o; a decisão é sua apenas quando o briefing é silencioso. Então você faz a única chamada — qual preset: leia ../hyperframes-creative/references/design-spec.md e escolha o preset cuja aparência melhor se adequa à marca e ao briefing. 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 o remixa nos tokens de 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; a fonte de exibição + corpo do preset trocada pela da marca), copia a skin de legenda do preset para .hyperframes/caption-skin.html e se auto valida (sai 1 em um mapeamento quebrado). Prossiga para a próxima etapa assim que ele sair 0 — sem edição manual da especificação.
tokens.json sem cores/fontes de marca (por exemplo, sem captura) → o script mantém a paleta própria do preset, um design completo e enviável. Se o briefing nomear cores/fontes de 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.
Porta: build-frame.mjs saiu 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; o preset escolhido foi registrado como uma preferência (--key style_preset --workflow <este fluxo de trabalho>, contrato de briefing § 2).
Etapa 3: Storyboard e Script
Objetivo: Transformar o briefing e o material capturado em um plano de história quadro a quadro aprovado.
Leia ../hyperframes-creative/references/story-spine.md (linguagem do gancho, valor antes da evidência, storyboard como proposta), 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. Defina o duration: do frontmatter a partir do comprimento do briefing — uma expectativa aproximada; a montagem relata onde o corte final fica em relação a ela.
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 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 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 necessários das referências de storyboard e script.
Após o rascunho, execute a passagem de plano do loop de revisão — ../hyperframes-core/references/review-loop.md § 1: abra o quadro (não pergunte se deve), apresente o plano como uma proposta e faça as duas perguntas — aprovar ou alterar, e rascunhos primeiro (recomendado) ou pular. O feedback passa pelo bate-papo ou pelo arquivo de comentários do quadro até ser aprovado. Esta é uma porta de ponto de verificação (contrato de briefing § 1): no modo autônomo, não há quadro e nada a perguntar — publique o mesmo resumo como um aviso e prossiga; os rascunhos são incorporados na construção, e a única pergunta de pré-visualização vem na Etapa 6.
Porta: STORYBOARD.md existe com seus campos estruturais; SCRIPT.md existe (quando a narração é necessária); a passagem do plano foi concluída; e a confirmação foi registrada ou o modo autônomo prosseguiu.
Etapa 3.1: Planejamento de Áudio
Objetivo: Selecionar BGM, efeitos sonoros e configuração de voz da biblioteca HeyGen ou provedores offline.
Consulte as regras em ../hyperframes-creative/references/audio-strategy.md. As escolhas de faixa vêm do catálogo do provedor de áudio resolvido por /media-use, não de um cache local ou de caminhos de arquivo conjecturados. Execute a consulta assim que o storyboard e o script forem aprovados. Defina as seleções em audio_meta.json, com campos: bgm_track_id, voice_id, sfx_cues conforme sfx_schedule no storyboard. A Etapa 5 deve ser capaz de usar audio_meta.json sem mais consultas.
Porta: audio_meta.json existe (bgm_track_id, voice_id definidos; sfx_cues do storyboard, quando aplicável) e as faixas foram resolvidas a partir do catálogo ativo.
Etapa 4: Design Visual
Objetivo: Ancorar cada quadro visual em uma fonte de verdade de ativos e finalizar o layout e a composição.
Do STORYBOARD.md rascunhado + inventário de ativos: atribua a cada quadro um ativo do asset-descriptions.md ou capture uma nova captura de tela/ativo sob demanda. Se o arquivo de ativos existir, anote seu caminho exato (relativo a ./capture/assets/); se precisar ser criado, especifique uma instrução para capture/assets/<quadro-id>/.
Componha planos de fundo, posicionamento de camadas e layout de texto aplicando frame.md e o guia de movimento em ../hyperframes-animation/rules/motion.md. Escreva as decisões de design no próprio STORYBOARD.md: uma seção ## Quadro NN: Design Visual abaixo de cada entrada de história, detalhando layout, camadas, animação de entrada/saída, tratamento de legendas e posicionamento de ativos. Ainda sem HTML — isso vem na Etapa 5.
Porta: Cada quadro de tomada em STORYBOARD.md tem uma seção ## Quadro NN: Design Visual com layout, camadas e atribuição de ativos. Deve ser acionável para construção de quadros.
Etapa 5: Construção de Quadros
Objetivo: Despachar um subagente por quadro para renderizar HTML/CSS/JS no compositions/frames/NN-*.html e montar em compositions/index.html.
Orquestração, não construção. Leia o quadro de design visual de STORYBOARD.md para cada quadro. Para cada um, crie um arquivo de prompt a partir do modelo em ../hyperframes-animation/blueprints/frame-worker-template.md — ele carrega as regras de movimento (framing, pacing, easing) das referências locais e da skill hyperframes-animation. Despache um subagente para construir cada NN-*.html. Cada subagente trabalha isoladamente: seu quadro é executado em um iframe, então nenhum ID deve vazar entre eles. Após todos os quadros serem construídos, monte compositions/index.html a partir do modelo em ../hyperframes-creative/references/player-template.html — ele carrega quadros em sequência e gerencia o loop de reprodução.
Tratamento de legendas: A skin de legenda é .hyperframes/caption-skin.html (da Etapa 2). O subagente da Etapa 4 deve projetar o layout do quadro para evitar sobreposição com a área de legenda. A Etapa 5 define o slot JS para preenchê-lo a partir do script.
Porta: compositions/frames/NN-*.html existe para cada quadro; compositions/index.html existe e carrega todos os quadros. Cada quadro é estável e não vaza IDs. O slot de legenda está presente.
Etapa 6: Renderização Final
Objetivo: Prévia, aprovação do usuário, mesclagem de áudio e renderização final.
Execute npx hyperframes serve no diretório do projeto e forneça ao usuário o URL http://localhost:3333/compositions/. A Etapa 6 é controlada pelo usuário, então o caminho depende do modo:
- Colaborativo: Peça ao usuário para visualizar e aprovar. Eles podem solicitar alterações em frames específicos; faça a edição manual e re-execute a Etapa 5 para esse quadro se necessário (a Etapa 5 suporta execução por quadro). Após a aprovação, mescle o áudio:
npx hyperframes render --compositions-dir ./compositions --audio ./audio_meta.json --output ./renders/video.mp4. Forneça o caminho final. - Autônomo: A aprovação é implícita. Prossiga para a renderização sem revisão. Após a renderização, informe onde o arquivo está.
Manipulação de erros de renderização: Se a renderização falhar, registre a saída de erro e tente novamente uma vez. Se falhar novamente, informe o usuário com o erro e pare. Não repita mais de uma vez.
Porta: O usuário aprovou (colaborativo) ou a renderização foi concluída (autônomo); renders/video.mp4 existe e é jogável. O caminho foi comunicado.
Notas Finais
- Memória de preferências: O sistema de preferências (
<DIR_DE_MIDIA>/scripts/prefs.mjs) registra respostas para reutilização entre projetos. Useprefs recordpara opções do usuário,prefs recallpara recuperar configurações padrão. - Tratamento de erros: Qualquer comando que falhe (saída diferente de zero) é uma parada. Relate o erro e pare, a menos que as instruções da etapa digam explicitamente para continuar (por exemplo, falha de autenticação na Etapa 0).
- Roaming de diretório: Todos os caminhos relativos são relativos a
<RAIZ_DO_PROJETO>após a Etapa 0. Não alterecwdpara fora dele.