media-use: Antes de buscar áudio/imagens, chame
/media-usepara resolver BGM/SFX/imagens do catálogo do HeyGen. Execute--adoptprimeiro para registrar ativos existentes. Consulte a habilidade/media-use.
Website para HyperFrames
Capture um site e produza um vídeo profissional a partir dele.
Confirme a rota antes do Passo 0. Esta skill cria um vídeo de / de um site genérico. Se o usuário está realmente comercializando / lançando / promovendo um produto (mesmo a partir desta URL, mesmo "promoção para nosso site") →
/product-launch-video. Um explicador de tópico sem site →/faceless-explainer; um PR do GitHub →/pr-to-video; re-cortar / recolorir / reordenar um arquivo de vídeo existente → fora do escopo. Roteado aqui por um vago "fazer um vídeo", ou não tem certeza entre lançamento vs. site geral? Leia/hyperframesprimeiro (tabela de roteamento completa + § O que o HyperFrames não pode fazer).
Os usuários dizem coisas como:
- "Transforme este site em um clipe social de 15 segundos para o Instagram"
- "Faça um tour / showcase de 30 segundos do site a partir de https://..."
- "Capture nossa página inicial e construa um vídeo a partir de seus próprios visuais"
O fluxo de trabalho tem 7 etapas. Cada uma produz um artefato que condiciona a próxima. Por padrão, é colaborativo — portões marcados com 💬 param e perguntam ao usuário. Se o usuário sinalizar modo autônomo ("decida por mim", "me surpreenda"), os portões de preferência do usuário 💬 são ignorados; veja step-2-brief.md para saber como isso se propaga.
O modo autônomo NÃO é "pular todos os portões." O modo automático cobre perguntas de preferência do usuário (provedor TTS, voz, ênfase de cor, contagem de batidas, música sim/não, legendas sim/não — onde o agente decide em nome do usuário). Ele NÃO cobre portões de verificação de qualidade. Os seguintes itens permanecem não puláveis no modo automático:
- Auditoria de Ativos (Passo 3) — visualizar folhas de contato e justificar USAR/PULAR para cada ativo
- Leitura de HTML por batida (Passo 5) — bloco de evidência estruturada por batida
- Checklist DoD (Passo 6) — incluindo mapa de animação, verificação WCAG por aviso, reprodução de áudio/movimento
- Seção de divulgação honesta (Passo 6) — "O que eu NÃO verifiquei" deve aparecer em seu resumo final
Se você se pegar pensando "o modo automático diz para tender à ação, então vou pular X" — e X é um portão de verificação, não uma pergunta de preferência — esse raciocínio está errado. A tendência à ação se aplica a decidir o que construir, não a decidir se deve verificar.
Passo 0: Capturar e Entender a Marca
Leia: references/step-0-capture.md
Capture o site, em seguida leia os dados extraídos para entender a marca e o produto — o que ele faz, para quem é, em que voz fala, em que humor vive. Os ativos capturados são um kit de ferramentas da marca para depois, não os blocos de construção dos quais o vídeo é feito.
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 "ir"/"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 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.) Consulte ../hyperframes-media → Preflight para obter a orientação canônica.
Portão: Resumo do site impresso — estratégia primeiro (o que o produto faz, para quem é, voz da marca) antes do inventário de ativos / cores / fontes; o status de login foi mostrado (logado, ou continuando offline).
Passo 1: Identidade da Marca
Leia: references/step-1-design.md
Escreva DESIGN.md — uma folha de consulta da marca cobrindo a identidade visual: cores, tipografia, estilos de componente, princípios de layout. Use design-styles.json para valores computados exatos.
Opção de velocidade: Para vídeos de ritmo rápido (batidas estilo outdoor), o DESIGN.md pode ser um resumo de 50 linhas com cores + fontes + o que fazer/não fazer — não um documento de 300 linhas. O prompt do subagente no Passo 5 cola os valores da marca diretamente, portanto a profundidade do DESIGN.md só importa para composições complexas.
Portão: DESIGN.md existe (qualquer tamanho) com no mínimo: paleta de cores, escolhas de fonte e o que fazer/não fazer.
Passo 2: Estratégia e Mensagem
Leia: references/step-2-brief.md, references/capabilities.md (escaneie o Sumário — seções de aprofundamento apenas conforme necessário)
Alinhe com o usuário sobre o que o vídeo deve comunicar antes de falar sobre visuais ou ativos. Analise o prompt do usuário — provavelmente ele já forneceu o tipo e estilo de vídeo. Pergunte apenas o que está faltando: a ÚNICA coisa que este vídeo deve dizer, o arco narrativo e o público-alvo.
Portão: Tipo de vídeo, duração, formato e — criticamente — a mensagem e o arco narrativo estão definidos. Sem eles, o Passo 3 não pode escrever um storyboard baseado em conceito.
Passo 3: Storyboard + Roteiro 💬
Leia: references/step-3-storyboard.md
Escreva o storyboard com foco no conceito: mensagem → arco narrativo → batidas que servem ao arco → técnicas por batida → toques de marca no final. Em seguida, escreva o roteiro de narração para corresponder. Apresente ambos ao usuário com um resumo batida a batida. Itere até que ele aprove.
Portão: STORYBOARD.md + SCRIPT.md existem E o usuário aprovou o plano.
Passo 4: Locução, Tempo e Legendas 💬
Leia: references/step-4-vo.md
Se o Passo 2 disse sem narração — pergunte sobre música de fundo e pule para o Passo 5. Caso contrário: pergunte ao usuário qual provedor TTS (HeyGen TTS, ElevenLabs ou Kokoro), gere áudio, transcreva, mapeie timestamps para as batidas. Em seguida, pergunte sobre legendas.
Portão: Ou (a) nenhuma narração foi solicitada e o storyboard tem tempos manuais de batida, ou (b) narration.wav + transcript.json existem e os tempos das batidas foram atualizados com durações reais.
Passo 5: Construir Composições
Leia: A skill hyperframes (carregue-a — cada regra importa)
Leia: references/step-5-build.md
Construa index.html e composições seguindo a arquitetura e o ritmo escolhidos no storyboard (Passo 3). Subagentes executam hyperframes lint e hyperframes snapshot em cada batida antes de relatar.
Portão: Cada compositions/beat-N.html foi lido de cima a baixo pelo agente principal em relação a DESIGN.md e STORYBOARD.md. O checklist por batida está em step-5-build.md.
Passo 6: Validar e Entregar
Leia: references/step-6-validate.md
Linte, valide, tire snapshots dimensionados para a duração do vídeo (fórmula: max(batidas × 3, ceil(duração_em_segundos / 2))) e revise cada um. Corrija problemas antes de entregar. Entregue a URL do projeto Studio localhost — renderize para MP4 apenas mediante solicitação explícita do usuário. Exiba essa URL do Studio apenas na entrega — ela é a prévia final e estável; os snapshots da fase de construção são headless, portanto não abra uma prévia no meio da construção.
Entregue algo de que você se orgulhe. Antes de entregar, pergunte-se: eu postaria isso nas redes sociais com meu nome? Se não, corrija o que está errado.
Portão: npx hyperframes lint e npx hyperframes validate passam com zero erros, e a resposta final inclui a URL do projeto Studio ativo.
Referência Rápida
Tipos de Vídeo
Restrições típicas por tipo de vídeo — use como ponto de partida, não como fórmula. A contagem de batidas deve vir do conteúdo e da narração, não de uma faixa alvo.
| Tipo | Duração típica | Direcionador de duração | Narração |
|---|---|---|---|
| Anúncio social (IG/TikTok) | 10–15s | Limite da plataforma | Opcional |
| Demonstração de produto | 30–60s | Tamanho do roteiro | Narração completa |
| Anúncio de recurso | 15–30s | Complexidade do recurso | Narração completa |
| Reel de marca | 20–45s | Faixa musical | Opcional, foco musical |
| Teaser de lançamento | 10–20s | Energia do gancho | Mínimo |
A contagem de batidas não está intencionalmente nesta tabela — ela deve vir do storyboard, não de "anúncio social = 3-4 batidas". Um anúncio social para um produto complexo pode precisar de 5 batidas bem ritmadas. Um reel de marca com uma tese visual forte pode precisar de 3.
Formato
- Paisagem: 1920x1080 (padrão)
- Retrato: 1080x1920 (Instagram Stories, TikTok)
- Quadrado: 1080x1080 (feed do Instagram)
Arquivos de Referência
| Arquivo | Quando ler |
|---|---|
| step-0-capture.md | Passo 0 — capturar, entender a marca e o produto, escrever resumo do site com foco em estratégia |
| step-1-design.md | Passo 1 — escrever DESIGN.md folha de consulta da marca (5 seções, 250-350 linhas; caminho rápido de 50 linhas para anúncios sociais estilo outdoor) |
| step-2-brief.md | Passo 2 — alinhar mensagem, arco narrativo, público-alvo com o usuário |
| capabilities.md | Passos 2 e 5 — inventário completo do que o HyperFrames pode fazer (24 seções). Escaneie o Sumário durante o briefing, aprofunde seções específicas durante a construção |
| step-3-storyboard.md | Passo 3 — storyboard + roteiro (combinados) com portão de revisão do usuário |
| step-4-vo.md | Passo 4 — escolha do provedor TTS, geração, temporização |
| step-5-build.md | Passo 5 — construir index.html + composições |
| step-6-validate.md | Passo 6 — lint, validação, snapshots (dimensionados para duração do vídeo), prévia |
| techniques.md | Passos 3 e 5 — 13 técnicas de animação primitivas com padrões de código (adapte, não copie e cole) |
| html-in-canvas-patterns.md | Passo 5 — padrões de código completos para efeitos HTML-em-Canvas (vive na skill hyperframes) |