Communitygithub.com

hyperframe — roteador para HeyGen HyperFrames

Roteador fino para o HeyGen HyperFrames — mecanismo de motion graphics nativo em HTML (escreva HTML, renderize MP4 determinístico localmente via headless Chrome + FFmpeg).

O que é hyperframe — roteador para HeyGen HyperFrames?

Esta skill é um roteador fino para o HeyGen HyperFrames, um mecanismo de motion graphics que transforma composições HTML/CSS/JS em MP4s determinísticos usando headless Chrome e FFmpeg. Ela é ideal para criar vídeos animados a partir de HTML, como textos cinéticos, captions animados, lower-thirds, end cards e outros elementos de motion graphics. A skill suporta plataformas como Claude Code e Cursor, e funciona roteando intenções do usuário para workflows específicos dentro do repositório clonado do HyperFrames. É importante notar que esta skill não deve ser usada para vídeos generativos (que pertencem à skill /vidgen) nem para sobreposições de texto estático do StayFrame (que pertencem à skill /jstack-sf-caption). O usuário pode explorar o catálogo de blocos e componentes, executar renders e validar composições usando comandos CLI como `npx hyperframes init` e `npm run render`.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jonosin/jstack/tree/HEAD/skills/hyperframe

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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 blocoshyperframes.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çãoVá 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-headFluxo 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 componentesDiretó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 RemotionA 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 init nã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-depth ou você obterá um blob de registro skills.sh desatualizado que fica atrás do main.
  • Telemetria está ativada por padrão; desative com hyperframes telemetry disable.
  • A saída do render vai para renders/[projeto]_[timestamp].mp4 dentro do diretório do projeto.

Próximas skills

PróximaQuando
/vidgenA 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-captionUm 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-stitchUma sobreposição/end card do HyperFrames renderizada precisa ser montada em um reel do StayFrame.

Habilidades Relacionadas