HyperFrames — comece aqui
HyperFrames renderiza vídeo a partir de HTML — uma composição é um arquivo HTML cujo DOM declara temporização com atributos data-*, cujo runtime de animação é buscável, e cuja reprodução de mídia é gerenciada pelo framework. O contrato completo de autoria está em /hyperframes-core; leia-o antes de escrever o HTML da composição.
Abaixo: um mapa de capacidades (as habilidades de domínio, carregadas sob demanda) e o roteador de intenções (escolha um workflow para qualquer "crie um vídeo para mim").
Mapa de capacidades — as habilidades de domínio
Capacidades atômicas que você carrega sob demanda — não workflows completos de vídeo. Para "crie um vídeo", use o roteador de intenções abaixo.
| Você quer… | Habilidade |
|---|---|
Criar / editar uma composição HTML — o contrato data-*, clipes, trilhas, subcomposições, variáveis | /hyperframes-core |
| Animar — movimento atômico, blueprints de cena, transições, adaptadores de runtime (GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU) | /hyperframes-animation |
Direção criativa — frame.md / design.md, paletas, tipografia, narração, planejamento de batidas, reativo a áudio | /hyperframes-creative |
| Mídia — narração TTS, música de fundo, transcrição, remoção de fundo, legendas | /hyperframes-media |
Resolução de mídia — encontrar + congelar BGM, SFX, imagens, ícones do catálogo HeyGen em .media/ com manifesto de rastreamento | /media-use |
| Loop de desenvolvimento CLI — init, lint, validar, inspecionar, pré-visualizar, renderizar, publicar, doctor | /hyperframes-cli |
Instalar blocos / componentes do registry (hyperframes add) | /hyperframes-registry |
Roteamento de intenções — escolha um workflow
Esta seção conhece apenas os workflows de alto nível; ela não carrega suas referências internas ou as habilidades de domínio acima.
Antes de rotear — confirme a entrada, não a especificação
O roteamento precisa saber sobre o que é o vídeo — sua entrada e assunto. Se isso não estiver especificado ("crie um vídeo sobre nossa coisa" sem URL, produto, tópico ou ativo), pergunte antes de entrar em qualquer workflow — comprometer-se com um workflow JÁ é a decisão de roteamento. No máximo duas perguntas:
- Entrada — um produto (URL / briefing), um site genérico, um PR do GitHub, um tópico a explicar, ou um vídeo existente de talking-head?
Padrões de especificação — declare, não pergunte (eles nunca mudam a rota): proporção 16:9 (use 9:16 apenas para um destino vertical nomeado — TikTok / Reels / Shorts); idioma da narração / legenda = o do usuário. O workflow escolhido re-confirma seus próprios específicos em seu primeiro passo.
Cola de workflows
| Workflow | Use para |
|---|---|
/product-launch-video | Marketing / lançamento / promoção de um produto — a partir de sua URL, um briefing, ou um roteiro (mesmo que o site seja apenas nomeado) |
/website-to-video | Transformar um site genérico em um vídeo — tour pelo site, showcase de portfólio / landing-page, clipe social a partir dos visuais do site |
/faceless-explainer | Explicar um tópico / conceito a partir de texto — sem produto, sem URL; cada visual é inventado por LLM |
/pr-to-video | Um PR do GitHub / mudança de código → changelog / revelação de recurso / correção / explicador de refatoração |
/embedded-captions | Adicionar legendas / subtítulos a um vídeo existente de talking-head (filmagem inalterada) |
/talking-head-recut | Empacotar um vídeo existente de talking-head com overlays gráficos projetados — terços inferiores, chamadas de dados, títulos cinéticos, citações em destaque |
/motion-graphics | Um motion graphic curto, sem narração e focado em design — tipo cinético, uma estatística / gráfico impactante, uma vinheta de logotipo, um overlay de terço inferior |
/music-to-video | Uma faixa de música → um vídeo sincronizado com a batida — vídeo lírico, slideshow ou promo cinético; a música dita o ritmo (opcional: imagens / vídeos do usuário cortados na grade de batidas) |
/slideshow | Uma apresentação / pitch deck / deck interativo — slides discretos, fragmentos, ramificações, hotspots; a saída é um deck navegável, não um vídeo renderizado |
/general-video | Qualquer outra coisa — peças mais longas ou com múltiplas cenas, um loop estático / pôster, uma composição personalizada |
/remotion-to-hyperframes | Portar uma composição existente do Remotion (React) para HyperFrames (migração, não criação) |
Desambiguação (apenas onde pode haver confusão):
- Foco em movimento e sem narração (menos de ~10s, o movimento é a mensagem) →
/motion-graphics, independentemente da entrada. - Uma URL ou roteiro — comercializa um produto específico (mesmo apenas nomeando o site) →
/product-launch-video; um site genérico não-produto →/website-to-video; um link de PR do GitHub →/pr-to-video; explica um conceito sem produto / site →/faceless-explainer. Se genuinamente não estiver claro entre produto-vs-tópico, ou lançamento-vs-site-genérico → faça uma pergunta. - Filmagem existente — legendas simples de fala →
/embedded-captions; cartões de overlay projetados →/talking-head-recut. Nenhum deles edita a filmagem em si (re-temporização / recolor / reenquadramento / reordenação / áudio é edição NLE — fora do escopo). - Uma faixa de música é a entrada (um arquivo de áudio, ou um vídeo para extrair áudio) sem narração →
/music-to-video— as batidas/energia da música ditam o ritmo. (Peças narradas permanecem no workflow correspondente à entrada acima;/motion-graphicsé para motion curto sem narração que não é conduzido por música.) - Uma apresentação / pitch deck / deck interativo (slides discretos, navegação, modo apresentador) →
/slideshow— a saída é um deck navegável, não um vídeo renderizado. Um pedido explícito de "slideshow" segue diretamente; um gatilho adjacente ("deck / slides / apresentação / converter esta página") faz/slideshowconfirmar que é um slideshow antes de criar, e mudar para o workflow não-slideshow apropriado se não for. - Duração é um guia, não uma barreira — a intenção escolhe o workflow; vá para
/general-videoapenas quando a peça for claramente mais longa que ~3 min, ou for um formato estático / loop / personalizado.
Se o workflow correspondente não estiver instalado
Depois de escolher um workflow, verifique se ele está realmente disponível para você. Se o skill do workflow correspondente não estiver instalado, não recorra a adivinhação — diga ao usuário para instalá-lo primeiro:
- Apenas este workflow:
npx skills add heygen-com/hyperframes --skill <nome-do-workflow>(ex.:--skill pr-to-video— nome simples, sem barra inicial). - Todos os workflows de uma vez:
npx skills add heygen-com/hyperframes --all(core + todos os workflows, pula o seletor).
Depois que ele executar, releia o skill do workflow e continue.
Detalhes dos workflows
/product-launch-video
- Entrada: Um produto sendo comercializado — (a) uma URL do produto (crawleada com Chrome headless para ativos + tokens de marca), (b) um roteiro / briefing que nomeia o site do produto mesmo sem link (PLV resolve + crawleia, a menos que o usuário opte por não fazer), ou (c) um roteiro sem site derivável / "não raspe" (modo sem captura — escolha um preset de estilo que forneça paleta + sistema de design). Um roteiro fornecido pode ser a narração literal ou reestruturado por cena — PLV pergunta.
- Saída: lançamento de produto / promo SaaS como uma composição HyperFrames → MP4. (ponto ideal 30–90s).
- Gatilhos: "vídeo de lançamento para X", "promo para nosso site", "explique meu SaaS em um minuto", "transforme meu roteiro em um promo de 60s", "vídeo de lançamento só com texto, não raspe".
/website-to-video
- Entrada: Um site / URL genérico para transformar em vídeo — quando o objetivo é um vídeo do site, não um lançamento de produto. Capturado com Chrome headless para screenshots reais + ativos de marca.
- Saída: um tour pelo site / portfolio / showcase de landing-page / clipe social construído a partir dos visuais do próprio site → MP4.
- Gatilhos: "transforme este site em um vídeo", "tour do site de ", "clipe social da nossa homepage", "eu só tenho uma URL — crie algo".
/faceless-explainer
- Entrada: Texto arbitrário — um tópico, artigo ou notas — sendo explicado, sem produto sendo comercializado e sem site para capturar. (Forkado de
/product-launch-video; sem Chrome headless.) - Saída: explicator sem rosto → MP4, cada visual inventado por LLM por cena (tipografia / abstrato / diagrama / visualização de dados); inclui o preset
pin-and-paper. (ponto ideal 30–90s). - Gatilhos: "explicador sem rosto sobre X", "explique como o DNS funciona em vídeo", "transforme este artigo em um explicador", "explicador a partir das minhas notas".
/pr-to-video
- Entrada: Um pull request do GitHub — uma URL de PR, uma referência
owner/repo#N, ou "este PR" — lido via CLIgh(não um site para raspar). - Saída: explicador de mudança de código (changelog / revelação de recurso / correção / refatoração) → MP4 — destaques de diff, antes/depois, árvore de arquivos + cenas de impacto. ≤ (ponto ideal 30–90s).
- Gatilhos: "crie um vídeo sobre este PR", "transforme o PR #1187 em um vídeo de changelog", "vídeo de notas de lançamento de github.com/org/repo/pull/123".
/embedded-captions
- Entrada: Um vídeo existente de talking-head (MP4) para legendar — filmagem real, não uma URL ou briefing. Transcrição local (Whisper, sem chave de API) e matting (RVM) para que o sujeito possa ocultar legendas.
- Saída: a mesma filmagem inalterada, com uma camada de legenda — Padrão (trilho inferior literal + um clímax embutido atrás do sujeito) ou Cinematográfica (cada legenda composta atrás do sujeito). Qualquer duração.
- Gatilhos: "adicione legendas / subtítulos a este vídeo", "legendas atrás do sujeito", "legendas cinematográficas para meu clipe".
/talking-head-recut
- Entrada: Um vídeo existente de talking-head / entrevista / podcast (MP4) para empacotar com gráficos na tela — filmagem real. Transcrição local (Whisper). O clipe toca por completo por baixo, inalterado.
- Saída: a mesma filmagem com cartões de overlay gráfico temporizados — títulos cinéticos, terços inferiores, chamadas de dados, citações em destaque, painéis laterais, picture-in-picture — sincronizados com a transcrição. Qualquer duração.
- Gatilhos: "empacote este vídeo", "adicione overlays gráficos / terços inferiores / chamadas de dados à minha palestra", "transforme esta entrevista em uma edição empacotada com gráficos".
/motion-graphics
- Entrada: Um motion graphic curto e focado em design onde o movimento é a mensagem — tipicamente menos de ~10s, sem narração. Gêneros: tipografia cinética, uma contagem de estatística / número, um impacto de gráfico, uma vinheta de logotipo, um terço inferior / overlay, ou uma página / tweet / manchete impulsionada por busca.
- Saída: um motion graphic curto → MP4 ou um overlay transparente (alpha WebM / MOV) para um terço inferior / chamada.
- Gatilhos: "uma vinheta de logotipo de 8s", "anime esta estatística", "uma introdução de tipo cinético", "transforme este tweet em um motion graphic", "um overlay de terço inferior transparente".
/music-to-video
- Entrada: Uma faixa de música — um arquivo de áudio, ou um vídeo para extrair o áudio — sem narração e sem captura de site. Opcionalmente, imagens / vídeos fornecidos pelo usuário para entrelaçar. A faixa é analisada uma vez em um mapa de batida / energia determinístico (
audiomap.json) no qual todo o vídeo é construído. - Saída: uma composição HyperFrames sincronizada com a batida → MP4 onde a música dita o ritmo. Tipografia e templates são o mínimo (um vídeo completo precisa de zero ativos); qualquer mídia fornecida é cortada na mesma grade de batidas (corte na batida / ken-burns). O gênero — vídeo lírico, slideshow, promo cinético — emerge das escolhas por quadro; o pipeline nunca ramifica nele.
- Gatilhos: "crie um vídeo para esta música", "vídeo sincronizado com a batida a partir desta faixa", "vídeo lírico", "transforme esta música em um vídeo", "visualizador de música / promo cinético para esta batida".
/slideshow
- Entrada: Uma apresentação / pitch deck / deck interativo para criar — um briefing, um esboço, ou uma página existente para converter em slides. Não é um pedido de vídeo renderizado; se a intenção for ambígua, o skill confirma "você quer isso como um slideshow do HyperFrames?" antes de criar.
- Saída: uma composição HyperFrames executável + uma ilha JSON que o
SlideshowControllerdo player lê para transformar a timeline GSAP em um deck navegável — slides discretos, revelações de fragmento, sequências de ramificação, navegação por hotspot, modo apresentador e notas do apresentador. O entregável é um deck, não um MP4. - Gatilhos: "crie um pitch deck / apresentação / deck de slides", "um deck interativo", "converta esta página em slides", "um slideshow com modo apresentador".
/general-video
- Entrada: Qualquer coisa não acima — um briefing criativo, um único elemento para animar, uma edição em uma composição que você está construindo. Agnóstico a entrada e duração.
- Saída: uma composição HyperFrames (qualquer duração / formato) via o fluxo original: sistema de design → expansão de prompt → plano → layout-antes-da-animação → construção (delegando para as habilidades
hyperframes-*) → validação.