HyperFrames — comece aqui
HyperFrames renderiza vídeos a partir de HTML — uma composição é um arquivo HTML cujo DOM declara o timing com atributos data-*, cujo runtime de animação é buscável, e cuja reprodução de mídia é gerenciada pelo framework. O contrato de autoria completo está em /hyperframes-core; leia-o antes de escrever o HTML da composição.
Abaixo: um mapa de capacidades (os skills de domínio, carregados sob demanda) e o roteador de intenções (escolha um fluxo de trabalho para qualquer pedido do tipo "faça um…" — geralmente um vídeo, mas também uma apresentação navegável ou uma porta de composição). A divisão é de propriedade, não de tipo de saída: um fluxo de trabalho possui um entregável ponta a ponta (seu próprio diretório de projeto, etapas orientadas, subagentes, artefato final); um skill de domínio é uma camada de capacidade que um fluxo de trabalho utiliza durante a execução e nunca assume a propriedade da tarefa.
Mapa de capacidades — os skills de domínio
Capacidades atômicas que você carrega sob demanda — não são fluxos de trabalho completos; elas nunca assumem a tarefa ponta a ponta. Para intenções do tipo "faça um…", use o roteador de intenções abaixo.
| Você quer… | Skill |
|---|---|
Criar / editar uma composição HTML — o contrato data-*, clipes, faixas, 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 |
Criar keyframes seguros para busca — timelines GSAP, keyframes CSS, Anime.js, WAAPI, FLIP, paths, máscaras, morph/draw SVG, profundidade 3D, além de diagnósticos hyperframes keyframes | /hyperframes-keyframes |
Direção criativa — frame.md / design.md, paletas, tipografia, narração, planejamento de batidas, áudio-reativo | /hyperframes-creative |
| Mídia — resolver/gerar BGM, SFX, imagem, ícone, logotipo de marca, voz, gradação de cor, LUT; narração TTS, transcrição, remoção de fundo, legendas; reutilização entre projetos | /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 |
| Importar conteúdo do Figma — assets, tokens, componentes, storyboards → movimento reconstruído (REST/CLI); Motion (MCP), shaders (fonte MCP / exportação nativa) | /figma |
Roteamento de intenções — escolha um fluxo de trabalho
Esta seção conhece apenas os fluxos de trabalho de alto nível; ela não carrega suas referências internas nem os skills 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 ("faça um vídeo sobre nossa coisa" sem URL, produto, tópico ou asset), pergunte antes de entrar em qualquer fluxo de trabalho — comprometer-se com um fluxo de trabalho JÁ é a decisão de roteamento. No máximo duas perguntas:
- Entrada — um produto (URL / brief), um site genérico, um PR do GitHub, um tópico para explicar, ou um vídeo de cabeça falante existente?
- Fonte Figma — se a entrada for uma URL figma.com,
/figmaextrai assets/tokens/(componentes/storyboard) primeiro, independentemente de qual fluxo de trabalho abaixo for escolhido para o formato do vídeo; esse fluxo de trabalho então constrói a partir da saída de/figma— nunca dirigindo o Figma via ferramentas MCP brutas diretamente (pula sanitização SVG, proveniência e vinculação de token de marca).
Modo — se a requisição carrega um sinal autônomo contínuo ("surpreenda-me", "decida por mim", "apenas construa"), anote-o e passe-o para o fluxo de trabalho: toda a execução vai autônoma e nenhuma etapa posterior pergunta novamente. Sem sinal, o fluxo de trabalho pergunta o modo como sua primeira pergunta do brief. O padrão é colaborativo. (/motion-graphics é autônomo por design.) Semântica: hyperframes-core → references/brief-contract.md.
Padrões de especificação — declare, não pergunte (eles nunca mudam a rota): aspecto deriva do destino — feed social (X / LinkedIn / Instagram) → quadrado 1:1, TikTok / Reels / Shorts → 9:16, YouTube / incorporado / desconhecido → 16:9; idioma da narração / legenda = o do usuário. O fluxo de trabalho escolhido reconfirma seus próprios específicos em sua primeira etapa (semântica de campo: hyperframes-core → references/brief-contract.md).
Folha de dicas de fluxos de trabalho
| Fluxo de trabalho | Use para |
|---|---|
/product-launch-video | Vender um produto (SaaS, aplicativo, site da empresa / produto) — a partir de uma URL, brief ou script → um promo. O padrão para qualquer URL comercial, mesmo que o site seja apenas nomeado. |
/website-to-video | Mostrar o próprio site — um tour / showcase construído a partir das capturas de tela do próprio site. Para sites não comerciais (portfólio, blog, docs, pessoal, evento), ou quando o usuário quer um tour, não um promo. |
/faceless-explainer | Explicar um tópico / conceito a partir de texto — sem produto, sem URL; cada visual é inventado pelo LLM |
/pr-to-video | Um PR do GitHub / mudança de código → changelog / revelação de funcionalidade / correção / explicador de refatoração |
/embedded-captions | Adicionar legendas / subtítulos a um vídeo de cabeça falante existente (filmagem intacta) |
/talking-head-recut | Empacotar um vídeo de cabeça falante existente com sobreposições gráficas projetadas — terços inferiores, chamadas de dados, títulos cinéticos, citações de destaque |
/motion-graphics | Uma peça curta (~menos de 10s), não narrada, onde o movimento é a mensagem — tipo cinético, um destaque de estatística/gráfico, um sting de logotipo, um mapa animado, um tweet / manchete animado, um independente terço inferior / sobreposição (MP4 ou alfa transparente) |
/music-to-video | Uma faixa de música → um vídeo sincronizado com batidas — vídeo lírico, slideshow ou promo cinético; a música dita o ritmo (imagens / vídeos opcionais 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 de múltiplas cenas, um loop estático / pôster, uma composição personalizada |
/remotion-to-hyperframes | Portar uma composição Remotion (React) existente para HyperFrames (migração, não criação) |
Desambiguação (apenas onde confusível):
- Foco em movimento e não narrado (menos de ~10s, o movimento é a mensagem) →
/motion-graphics, independentemente da entrada. - Uma URL ou script — pergunte uma coisa: o site está vendendo um produto? Sim (SaaS / aplicativo / produto / site da empresa) →
/product-launch-video— um promo, e o padrão para qualquer URL comercial, mesmo que o site seja apenas nomeado. Não, ou o usuário apenas quer o site mostrado como está (portfólio / blog / docs / pessoal / evento) →/website-to-video— um tour. Um link de PR do GitHub →/pr-to-video; um conceito sem produto ou site →/faceless-explainer. - Filmagem existente — legendas simples de discurso falado →
/embedded-captions; cartões de sobreposição projetados →/talking-head-recut. Nenhum edita a filmagem em si (re-timing / recolorir / reenquadrar / reordenar / á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) com nenhuma narração →
/music-to-video— as batidas/energia da música ditam o ritmo. (Peças narradas permanecem com o fluxo de trabalho correspondente à entrada acima;/motion-graphicsé para movimento curto não narrado que não é impulsionado 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" prossegue diretamente; um gatilho adjacente ("deck / slides / apresentação / converter esta página") faz/slideshowconfirmar que é um slideshow antes de criar, e mudar para o fluxo de trabalho não-slideshow apropriado se não for. - Duração é um guia, não uma barreira — a intenção escolhe o fluxo de trabalho; vá para
/general-videoapenas quando a peça for claramente mais longa que ~3 min, ou for um formato estático / loop / personalizado.
Após escolher — garanta que o fluxo de trabalho está instalado
Depois de escolher um fluxo de trabalho, execute a etapa de atualização antes de ler seu skill — os skills de fluxo de trabalho são instalados sob demanda, então aquele que você escolheu pode não estar nesta máquina ainda (suas frases de gatilho vivem neste roteador precisamente para que você possa rotear para skills que não estão instalados):
npx hyperframes skills update <nome-do-fluxo-de-trabalho>
Nome simples, sem a / inicial — por exemplo, npx hyperframes skills update pr-to-video. Nomear um skill garante que ele mais os skills de domínio principais dos quais todo fluxo de trabalho depende estão instalados e atualizados: uma operação rápida sem efeito quando tudo já está, uma instalação direcionada apenas dos skills ausentes/desatualizados quando não — nunca o conjunto completo. Em seguida, leia o skill do fluxo de trabalho e continue. O mesmo comando funciona para um skill de domínio sob demanda do mapa de capacidades (por exemplo, npx hyperframes skills update figma).
Se o comando falhar, exiba seu erro ao usuário em vez de improvisar o fluxo de trabalho a partir da memória. Fallback manual (sem CLI do HyperFrames disponível): npx skills add heygen-com/hyperframes --skill <nome-do-fluxo-de-trabalho>; tudo de uma vez: npx skills add heygen-com/hyperframes --all.
Mantendo skills atualizados
Os skills do HyperFrames são versionados e instalados de forma preguiçosa: o conjunto central é instalado ansiosamente, os fluxos de trabalho no primeiro uso.
- Conjunto central — este roteador, os skills de domínio
hyperframes-*emedia-use.npx hyperframes init(que todo fluxo de trabalho de criação executa ao preparar o projeto) verifica o GitHub e atualiza o conjunto central mais qualquer outra coisa já instalada. Ele nunca expande a instalação — skills de fluxo de trabalho que você não usou não são puxados. Reexecutar init em uma máquina atualizada é uma operação sem efeito; offline (ou com limite de taxa) ele degrada graciosamente e nunca falha de forma grave. A flag--skip-skillsestá atualmente neutra (uma medida temporária enquanto o registry skills.sh se atualiza); CI/testes optam por sair via a variável de ambienteHYPERFRAMES_SKIP_SKILLS=1. - Skills de fluxo de trabalho — instalados e atualizados no momento do gatilho pela etapa de atualização acima (
skills update <nome-do-fluxo-de-trabalho>).
Se uma tarefa estiver se comportando inesperadamente, ou antes de uma longa construção, confirme que os skills instalados estão atualizados:
- Verificar:
npx hyperframes skills check(adicione--jsonpara um veredito legível por máquina; sai com código diferente de zero quando qualquer coisa instalada está desatualizada ou o conjunto central está incompleto — skills de fluxo de trabalho ainda não instalados são reportados como disponíveis sob demanda, não como uma falha). - Atualizar:
npx hyperframes skills update— atualiza o conjunto central mais tudo instalado para a versão mais recente, e remove skills que não são mais publicados. Sem nomes, nunca instala fluxos de trabalho que você não usou; nomeando skills (skills update <nome…>) adicionalmente instala esses. - Conjunto completo, explicitamente:
npx hyperframes skills(ounpx skills add heygen-com/hyperframes --all).
O CLI também exibe um lembrete de uma linha quando uma execução de render / lint / validate detecta skills desatualizados.
Detalhes dos fluxos de trabalho
/product-launch-video
- Entrada: Um produto sendo comercializado — (a) uma URL do produto (navegada com Chrome headless para assets + tokens de marca), (b) um script / brief que nomeia o site do produto mesmo sem um link (PLV resolve + navega nele, a menos que o usuário opte por não fazer), ou (c) um script sem site derivável / "não raspe" (modo sem captura — escolha um preset de estilo que forneça paleta + sistema de design). Um script fornecido pode ser a narração ipsis litteris ou reestruturada por cena — PLV pergunta.
- Saída: um promo de lançamento de produto / SaaS como uma composição HyperFrames → MP4 (ponto ideal 30–90s) — o valor do produto é o assunto, não um passo a passo do site. Para um simples tour do site, use
/website-to-video. - Gatilhos: "vídeo de lançamento para X", "promo para nosso site", "explique meu SaaS em um minuto", "transforme meu script em um promo de 60s", "texto