Instalação do plugin: Antes dos comandos de configuração ou atualização, siga as regras de execução de plugin quando esta skill estiver dentro de um plugin HyperFrames. Instalações independentes mantêm as instruções de atualização abaixo.
Primeiro, mantenha esta skill atualizada — 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, atualiza esta skill e as skills de domínio principal das quais ela depende antes que você as utilize.
media-use: Antes de obter áudio/imagens/logos, chame
/media-usepara resolver BGM/SFX/imagens do catálogo HeyGen e logotipos da marca de suas fontes oficiais. Execute--adoptprimeiro para registrar ativos existentes. Veja a skill/media-use.
figma source: Se a fonte for uma URL figma.com, execute
/figmaprimeiro — exportação de ativos, tokens de marca e componentes/reconstrução de storyboard, se necessário — depois construa este fluxo de trabalho a partir de sua saída. Não dirija o Figma diretamente via ferramentas MCP brutas: isso ignora a sanitização SVG, a proveniência.media/manifest.jsonle a vinculaçãovar()dos tokens de marca, de modo que uma alteração posterior da marca não pode propagar sem uma reimportação completa.
Lançamento de Produto 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.
A porta de entrada é
/hyperframes. Você é o orquestrador. Execute cada etapa, verifique seu portão e só então continue para a próxima etapa. 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. Uma solicitação de tour / showcase de site também fica aqui:BRIEF.mdcarrega a intenção de mostrar como está, e as capturas de tela tornam-se os ativos que o vídeo apresenta. Qualquer outra intenção, um "faça um vídeo" simples ou qualquer incerteza → leia/hyperframesprimeiro — a camada de intenção possui cada 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/<project>/. Execute as etapas em ordem e passe cada portão antes de continuar. As etapas com portão 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 portão e como flow/storyboard do BRIEF.md 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 sub-agente por quadro. Não coloque regras de design ou movimento aqui; elas vivem no sub-agente frame-worker, nas regras ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/ locais a esta skill e em 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/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 do briefing § 1). (2) Sem 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 faltando. Nomeie <project> a partir da marca ou domínio em kebab-case, por exemplo, acme-promo; nunca use nome do espaço de trabalho ou timestamp.
npx hyperframes init "videos/<project>" --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 <PROJECT_ROOT> como videos/<project> e execute cada comando subsequente de caminho relativo com esse diretório como seu diretório de trabalho. Nos comandos abaixo, . significa <PROJECT_ROOT>; 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/references/brief-format.md. Resolva <MEDIA_DIR> como o diretório da skill /media-use instalada. Em seguida, registre cada resposta baseada em preferência com node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes . (brief-format.md nomeia o subconjunto). Se a camada de intenção adotou uma receita, execute node <MEDIA_DIR>/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 faz 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 além da Configuração — execute npx hyperframes auth status e retransmita 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 código 1 quando não está logado (e quando a credencial armazenada é rejeitada) — esse código de saída não zero é o estado normal de desconexão, não uma falha de comando, portanto não o trate como um erro, não o repita e não o 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 estado e continue pelos mecanismos locais disponíveis.
Não omita silenciosamente uma capacidade necessária quando não existir provedor offline; exponha o bloqueador. Não dobre esta decisão em outra pergunta nem 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 do briefing § 2); o status de login foi mostrado (logado ou continuando offline).
Etapa 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. 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 o tiver). Em seguida, resolva o alvo da captura: URL no texto -> use-a; apenas nome da marca -> WebSearch, confirme a URL em uma linha, depois 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 solicitante tenha um prazo menor; então passe um --capture-budget <milissegundos> positivo que deixe tempo para o trabalho a jusante. --timeout controla apenas a navegação da página. Use --skip-vision apenas quando a legendagem opcional de imagens estiver intencionalmente desativada.
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 brusca 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 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 mudar para uma captura de tela ou briefing fornecidos.
Avisos como "muito pouco conteúdo de texto" juntamente com um catálogo de ativos vazio não são prova de uma página utilizável. Para um tour de site ou briefing de mostrar como está, exija 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 de 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 imagem precisar de movimento interno, mantenha a captura de tela como base e sobreponha ativos 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 exato para uma janela de visualização de 1920 de largura percorrendo-o. Ela está ausente quando a página era muito alta para ser capturada em uma peça; recorra às capturas de sobreposição de posição de rolagem no mesmo diretório. Aprofundar além de 1:1 quer 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 solicitar 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 gera legendas automáticas de 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 título/descrição a partir 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 anotações de ativos.
Portão: 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 ativos. Se ele estiver faltando após a captura real, pare e relate a captura incompleta. Avisos sobre uma fase opcional degradada são aceitáveis apenas quando este portão estrutural ainda passa.
Etapa 2: Sistema de Design
Objetivo: Escolher um preset de quadro pré-definido; 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 das vitrines na camada de intenção — use-o; a decisão de julgamento é sua apenas quando o briefing está silencioso. Em seguida, 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 <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 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; 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); apenas ajuste frame.md manualmente depois se um mapeamento realmente precisar.
Portão: build-frame.mjs saiu com 0 — frame.md existe de um preset nomeado e (quando o preset fornece 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 do briefing § 2).
Etapa 3: Storyboard e Roteiro
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 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 o blueprint da história, gancho, lógica de persuasão, batidas, VO_MODE e escolhas de ativos. Como um guia suave, 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 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 a partir de capture/extracted/asset-descriptions.md (o inventário canônico) — não navegue pelo capture/assets/ bruto. Não peça ao usuário para escolher ativos, a menos que esse inventário esteja faltando ou seja inutilizável. 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 bate-papo; faça um loop até a aprovação. Este é um portão de checkpoint (contrato do briefing § 1): em modo autônomo. . .