O que hyperframe — roteador para HeyGen HyperFrames faz?
HyperFrames (Apache-2.0, github.com/heygen-com/hyperframes) transforma composições HTML/CSS/JS em MP4s determinísticos: o renderizador busca cada quadro no headless Chrome e codifica com FFmpeg. Esta skill é um ROTEADOR FINO — todo o conhecimento real reside no repositório clonado e suas próprias 20 skills de agente; nunca duplique a documentação upstream aqui.
Caminhos locais
Resolução: variável de ambiente HYPERFRAMES_HOME → ~/.jstack/config.env → padrão abaixo.
| O quê | Onde |
|---|---|
| Repositório clonado (cópia local canônica) | ~/.jstack/vendor/hyperframes |
| Skill roteador upstream (LEIA PRIMEIRO para qualquer solicitação de faça-um-vídeo) | ~/.jstack/vendor/hyperframes/skills/hyperframes/SKILL.md |
Suas 20 skills de agente (também instaladas em ~/.claude/skills/ + ~/.agents/skills/ por hyperframes init) | ~/.jstack/vendor/hyperframes/skills/ |
Registro de blocos/componentes (70+ blocos: lower-thirds lt-*, code-*, logo-outro, glitch, data-chart…) | ~/.jstack/vendor/hyperframes/registry/{blocks,components} |
| Fonte da documentação (Guia rápido, conceitos, referência, catálogo) | ~/.jstack/vendor/hyperframes/docs/ |
| Online: docs + catálogo de blocos | hyperframes.heygen.com (Guia Rápido/Docs/Catálogo), hyperframes.dev (playground + modelos de design) |
Instalação / verificação de saúde
Requisitos: Node 22+ e FFmpeg no PATH (verificado funcionando nesta máquina, CLI v0.7.48).
npx --yes hyperframes doctor # verificação de saúde do ambiente
npx --yes hyperframes init my-video # estrutura um projeto (também instala/atualiza suas skills de agente)
cd my-video && npm run render # → renders/*.mp4
init estrutura index.html + hyperframes.json e fixa a versão da CLI em package.json
scripts (dev/check/render/publish). Atualize o clone com
git -C ~/.jstack/vendor/hyperframes pull.
Tabela de roteamento
Roteie a intenção, depois ABRA/EXECUTE o alvo upstream — não improvise um fluxo de trabalho.
| Intenção | Vá para |
|---|---|
| Qualquer solicitação "faça-me um vídeo/animação" (ponto de entrada) | Leia a skill roteadora /hyperframes: ~/.jstack/vendor/hyperframes/skills/hyperframes/SKILL.md — ela escolhe o fluxo de trabalho |
| Texto de gancho animado / títulos cinéticos / stat hit / logotipo / end card / lower-third (curto, sem narração, voltado ao design) | Fluxo de trabalho /motion-graphics: skills/motion-graphics/ no clone; blocos lower-third = registro lt-*, end card = logo-outro |
| Legendas cinéticas / legendas em um vídeo existente de talking-head | Fluxo de trabalho /embedded-captions: skills/embedded-captions/ (filmagem intacta, legendas renderizadas sobre ela) |
Criar ou editar uma composição HTML→MP4 (o contrato de temporização data-*, clipes, faixas) | /hyperframes-core depois /hyperframes-animation: skills/hyperframes-core/, skills/hyperframes-animation/ |
| Navegar / instalar blocos e componentes | Diretórios do registro registry/{blocks,components} ou hyperframes.heygen.com/catalog; instale + conecte via /hyperframes-registry e npx hyperframes add [block] |
| Renderizar / pré-visualizar / lintar / validar uma composição | /hyperframes-cli: npx hyperframes preview, npx hyperframes lint && npx hyperframes validate, npx hyperframes render, npx hyperframes doctor |
| BGM / SFX / narração / ícones / remoção de fundo para uma composição | /media-use: skills/media-use/ |
| Deck / slideshow, promoção de produto, PR-para-vídeo, sincronizado com música, tour de site, portabilidade Remotion | A skill de fluxo de trabalho correspondente em skills/ (veja a folha de dicas do roteador /hyperframes) |
Quando NÃO usar (linha vermelha do StayFrame)
A estrela polar estética do feed do StayFrame (ADR 0002, mínimo-editorial — "isso passaria despercebido na grade Aman/Soneva?") torna estilos pesados de motion graphics FORA-DA-MARCA: legendas cinéticas ao estilo Hormozi, blocos glitch/VFX, tickers de notícias, widgets de vidro líquido. Para reels do StayFrame use HyperFrames apenas para sobreposições mínimas SUTIS, e:
- Sobreposições de texto estático permanecem na pista existente — headless-Chrome + ffmpeg via
/jstack-sf-caption. Não migre isso para HyperFrames. - Vídeo generativo (i2v/t2v) nunca é HyperFrames — isso é
/vidgen.
Pegadinhas
hyperframes initnão tem sinalizador--yes(erro em sinalizadores desconhecidos); já é não interativo.- Efeito colateral do
init: instala/atualiza as skills principais do HyperFrames em~/.claude/skills/e~/.agents/skills/— esperado, mantém o roteador upstream atualizado. - Instalação standalone de skills:
npx skills add heygen-com/hyperframes --full-depth— mantenha--full-depthou você obterá um blob de registro skills.sh desatualizado que fica atrás domain. - Telemetria está ativada por padrão; desative com
hyperframes telemetry disable. - A saída do render vai para
renders/[projeto]_[timestamp].mp4dentro do diretório do projeto.
Próximas skills
| Próxima | Quando |
|---|---|
/vidgen | A composição precisa de filmagem gerada (clipes i2v/t2v) como mídia de origem — a geração de vídeo sempre roteia para lá, nunca diretamente para um backend. |
/jstack-sf-caption | Um reel do StayFrame precisa de sobreposições de texto estático simples — essa pista permanece no headless-Chrome + ffmpeg, não no HyperFrames. |
/jstack-sf-trim-stitch | Uma sobreposição/end card do HyperFrames renderizada precisa ser montada em um reel do StayFrame. |