Instalação do plugin: Antes de comandos de configuração ou atualização, siga as regras de instalação de plugin quando este skill estiver dentro de um plugin HyperFrames. Instalações independentes mantêm as instruções de atualização abaixo.
Primeiro, mantenha este skill atualizado — confirme com o usuário antes de executar:
npx hyperframes skills update product-launch-video. Uma operação rápida sem efeito quando tudo está atualizado; caso contrário, ele atualiza este skill e os skills de domínio principal dos quais depende antes de você usá-los.
media-use: Antes de obter áudio/imagens/logos, chame
/media-usepara resolver BGM/SFX/imagens do catálogo HeyGen e logotipos de suas fontes oficiais. Execute--adoptprimeiro para registrar assets existentes. Consulte o skill/media-use. Quando o aplicativo host fornece suas próprias ferramentas de música ou efeitos sonoros, use-as para música e efeitos sonoros.
figma source: Se a fonte for uma URL figma.com, execute
/figmaprimeiro — exportação de assets, tokens de marca e reconstrução de componentes/storyboard, se necessário — então construa este fluxo de trabalho a partir de sua saída. Não dirija o Figma diretamente por meio de ferramentas MCP brutas: isso ignora a sanitização SVG, a proveniência.media/manifest.jsonle a vinculaçãovar()do token de marca, de modo que uma alteração posterior da marca não pode se propagar sem uma reimportação completa.
Lançamento de Produto para HyperFrames
Use este 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 'gate' e só então prossiga para a próxima etapa. Este skill é para um produto sendo comercializado, lançado, promovido ou revelado, incluindo solicitações como "promo para nosso site" quando o propósito é promocional. Uma solicitação de tour do site / showcase permanece aqui:BRIEF.mdcarrega a intenção de mostrar como está, e as capturas de tela se tornam os assets que o vídeo apresenta. Qualquer outra intenção, um simples "faça 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 'gate' antes de continuar. As etapas com gate do 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 gate e como flow/storyboard do BRIEF.md derivam o modo que governa as gates 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 vivem no subagente trabalhador de quadro, nos ../hyperframes-animation/rules/ locais deste 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 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 reinterrogue um projeto parcialmente 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/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 faltando. Nomeie <projeto> a partir da marca ou domínio em kebab-case, como acme-promo; nunca use nome do workspace ou timestamp.
npx hyperframes init "videos/<projeto>" --non-interactive --example=blank --skill=product-launch-video — init verifica os skills instalados em relação aos mais recentes no GitHub e atualiza o conjunto global se algum estiver desatualizado.
Após init, deixe <RAIZ_DO_PROJETO> ser videos/<projeto> e execute cada comando de caminho relativo subsequente com esse diretório como seu 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 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_DE_MIDIA> como o diretório do skill /media-use instalado. 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 gates de revisão ainda são executadas.
Mostre o status de login antes de prosseguir após a Configuração — execute npx hyperframes auth status e repasse sua saída literalmente. Ele informa se a voz/BGM usará HeyGen ou mecanismos locais e, quando desconectado, como fazer login. Observe o contrato de código de saída: auth status sai com 1 quando não está logado (e quando a credencial armazenada é rejeitada) — essa saída não zero é o estado normal de desconectado, 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; mostre o bloqueador. Não condense 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.
Gate: 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: Capturar assets
Objetivo: Coletar o material de origem, sinais de marca e assets 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 assets. 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 de alguma forma não tiver). Em seguida, resolva o alvo de captura: URL no texto -> use-a; apenas nome da marca -> WebSearch, confirme a URL em uma linha, então 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 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 não 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 assets. Não fabrique um fallback sintético sem captura após uma captura de URL falhada. Continue pelo caminho sem captura apenas quando o briefing original forneceu o material de origem, ou quando o usuário explicitamente muda para uma captura de tela ou briefing fornecidos após a falha.
Avisos como "muito pouco conteúdo de texto" juntamente com um catálogo de assets vazio não são prova de uma página utilizável. Para um tour do 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 um tour do site ou briefing de mostrar como está, a página capturada é a fonte de verdade visual. Use a captura de tela real em vez de reconstruir o site inteiro em HTML. Se o quadro precisar de movimento interno, mantenha a captura de tela como base e sobreponha assets capturados reais 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-exata para uma janela de 1920 de largura viajando sobre ela. Ela está ausente quando a página era muito alta para ser capturada em uma peça; recorra às capturas de posição de rolagem sobrepostas no mesmo diretório. Avançar além de 1:1 requer sua própria captura 2x dessa região, já que a placa não tem margem acima de 1x. Recrie a página inteira apenas quando o usuário explicitamente pedir uma interpretação estilizada; uma captura inutilizável sozinha não é autorização.
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 é uma gate 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.
Gate: o 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 assets. Se estiver faltando após a captura real, pare e relate a captura como incompleta. Avisos sobre uma fase opcional degradada são aceitáveis apenas quando esta gate 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 visualmente a partir dos showcases na camada de intenção — use-o; a decisão é sua apenas quando o briefing está 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. Então execute:
node <SKILL_DIR>/scripts/build-frame.mjs --preset <nome> --hyperframes .
O script faz o resto deterministicamente: copia o FRAME.md do preset → frame.md e o remixa sobre os 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; 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 a próxima etapa assim que ele 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 própria paleta do 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.
Gate: 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; 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 storyboard quadro a quadro aprovado.
Leia ../hyperframes-creative/references/story-spine.md (linguagem de gancho, valor antes da evidência, storyboard como proposta, recursos visualmente rastreáveis), 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; o relatório de montagem informa onde o corte final cai 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 asset. Como um guia flexível, consulte o menu 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 para 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 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, 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
... [truncado para tradução]