Communitygithub.com

HyperFrames

Gere vídeos MP4 determinísticos a partir de HTML, CSS, mídia e animações buscáveis usando o framework HyperFrames da HeyGen.

O que é HyperFrames?

HyperFrames é um framework open-source (Apache-2.0) da HeyGen que transforma HTML, CSS, mídia e animações em vídeos MP4 determinísticos — mesma entrada sempre produz a mesma saída. Ele analisa composições HTML anotadas com atributos de tempo `data-*`, usa Chrome headless para buscar e capturar cada quadro e codifica o resultado com FFmpeg. Não requer etapa de build, React ou taxa por renderização. O CLI é não interativo por padrão, ideal para pipelines automatizados. Suporta animações GSAP, CSS, Lottie, Three.js, Anime.js e WAAPI. É útil para desenvolvedores que desejam criar vídeos programáticos de forma confiável, como vídeos de lançamento, demonstrações de produto ou conteúdo dinâmico para redes sociais, tudo a partir de HTML simples.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/TerminalSkills/skills/tree/HEAD/skills/hyperframes

Perguntar na sua IA favorita

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

Prévia

Do README da skill

Documentação

O que HyperFrames faz?

Visão Geral

HyperFrames é um framework open-source (Apache-2.0) da HeyGen que transforma HTML, CSS, mídia e animações em vídeos MP4 determinísticos — mesma entrada sempre produz a mesma saída. Ele analisa composições HTML anotadas com atributos de tempo data-*, usa Chrome headless para buscar e capturar cada quadro e codifica o resultado com FFmpeg. Não há etapa de build, requisito de React ou taxa por renderização. É projetado para ser amigável a agentes: o CLI é não interativo por padrão, encaixando-se perfeitamente em pipelines automatizados de conteúdo.

Use esta habilidade para estruturar projetos, criar composições HTML, visualizá-las com recarga automática e renderizar vídeo quadro a quadro — incluindo animações com GSAP, CSS, Lottie, Three.js, Anime.js ou a Web Animations API.

Instruções

Pré-requisitos

Confirme o ambiente antes de começar:

  • Node.js 22+ (node --version)
  • FFmpeg no PATH (ffmpeg -version)
  • O Chrome/Chromium headless é baixado pelo mecanismo na primeira execução.

Estruturando um projeto

npx hyperframes init my-video    # estrutura um projeto (cria index.html + package.json)
cd my-video

Para configuração gerenciada por agente dentro de um workspace existente de agente de IA, a habilidade pode ser instalada com npx skills add heygen-com/hyperframes.

Criando uma composição

Composições são arquivos index.html simples. Um elemento raiz de palco declara a tela e o ID da composição; elementos filhos declaram quando aparecem e por quanto tempo duram por meio de atributos data-*. Os valores de tempo estão em segundos.

AtributoPropósito
data-composition-idNomeia a composição (alvo para render/inspecionar)
data-startQuando o elemento entra na linha do tempo (segundos)
data-durationQuanto tempo o elemento permanece na linha do tempo (segundos)
data-width / data-heightDimensões da tela em pixels (no elemento de palco)
data-track-indexOrdem da camada/faixa para áudio ou vídeo empilhados
data-volumeNível de áudio, 0.0–1.0

Visualizando e renderizando

npx hyperframes preview          # visualização no navegador com recarga automática durante a criação
npx hyperframes render           # busca cada quadro no Chrome headless, codifica para MP4 via FFmpeg
npx hyperframes lint             # valida a estrutura da composição antes de renderizar
npx hyperframes inspect          # exibe metadados da composição (duração, faixas, dimensões)

A resolução vem de data-width/data-height no palco; taxa de quadros, caminho de saída e codec são parâmetros de renderização (verifique npx hyperframes render --help para as flags exatas em sua versão instalada, pois os nomes das flags evoluem). Como a saída é determinística, re-renderizar a mesma entrada é seguro para cache.

Usando o catálogo de componentes

Blocos pré-construídos (transições, sobreposições, legendas, gráficos animados, mapas, efeitos) são instalados no projeto:

npx hyperframes add flash-through-white   # uma transição
npx hyperframes add data-chart            # um bloco de gráfico animado
npx hyperframes add instagram-follow      # uma sobreposição social

Navegue pelo catálogo completo em hyperframes.heygen.com/catalog e adicione blocos pelo nome.

Animações

Qualquer animação buscável e precisa por quadro funciona porque o mecanismo busca cada posição da linha do tempo deterministicamente, em vez de gravar em tempo real. Adaptadores suportados: GSAP, animações CSS, Lottie, Three.js, Anime.js, WAAPI e adaptadores personalizados. Evite aleatoriedade baseada em tempo ou movimento orientado por Date.now()/relógio de parede — vincule o progresso da animação à linha do tempo da composição para que as buscas sejam reproduzíveis.

Pipelines de agente / CI

O CLI é não interativo, portanto um fluxo automatizado típico é: gerar/modelar o HTML → hyperframes lint → hyperframes render → coletar o MP4. Para escala, o pacote @hyperframes/aws-lambda permite renderização distribuída no Lambda.

Exemplos

Exemplo 1: Renderizar uma composição de lançamento de produto

index.html:

<div id="stage" data-composition-id="launch"
     data-start="0" data-width="1920" data-height="1080">
  <video data-start="0" data-duration="6" src="intro.mp4"></video>
  <h1 id="title" data-start="1" data-duration="4">Dia do lançamento</h1>
  <audio data-start="0" data-duration="6" data-volume="0.8" src="music.wav"></audio>
</div>
npx hyperframes inspect            # confirma: launch, 6s, 1920x1080
npx hyperframes lint               # valida antes de gastar tempo de renderização
npx hyperframes render             # produz um MP4 1080p

Exemplo 2: Uma animação de título GSAP buscável

<div id="stage" data-composition-id="title-card"
     data-start="0" data-width="1080" data-height="1080">
  <h1 id="headline" data-start="0" data-duration="3">Resultados Q3</h1>
  <script src="https://cdn.jsdelivr.net/npm/gsap@3/dist/gsap.min.js"></script>
  <script>
    // Vincule o progresso à linha do tempo (tween pausado que o mecanismo busca), não ao tempo real.
    const tl = gsap.timeline({ paused: true });
    tl.from("#headline", { y: 80, opacity: 0, duration: 1 })
      .to("#headline", { scale: 1.05, duration: 2 });
    window.__seek = (t) => tl.seek(t);   // o mecanismo chama isso por quadro
  </script>
</div>
npx hyperframes preview            # itere ao vivo, depois:
npx hyperframes render

Diretrizes

  • Determinismo primeiro. Vincule todo movimento à linha do tempo da composição. Evite Math.random(), Date.now(), loops em tempo real ou chamadas de rede durante a renderização — eles quebram a reprodutibilidade.
  • Analise antes de renderizar. hyperframes lint detecta erros estruturais/de tempo de forma barata; a renderização é a etapa cara.
  • Defina a tela no palco. data-width/data-height ficam no elemento raiz da composição; o tempo dos filhos (data-start/data-duration) fica em cada elemento, em segundos.
  • Verifique o conjunto de ferramentas. A maioria das falhas se deve à falta de FFmpeg ou Node < 22, ou a um download do Chromium bloqueado por firewall.
  • Use --help para flags exatas. As opções de render/add variam por versão; confirme as flags de fps/saída/codec no CLI instalado, em vez de assumir.
  • Prefira blocos do catálogo. hyperframes add puxa componentes mantidos e buscáveis, em vez de criar transições e gráficos manualmente.
  • Escale com Lambda. Para trabalhos em lote/grandes, renderize via @hyperframes/aws-lambda em vez de um longo trabalho local.
  • Mantenha a mídia local e versionada. Referencie ativos por caminhos estáveis; buscas remotas durante a renderização prejudicam a determinismo e a reprodutibilidade.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

TerminalSkills/skills

>- Run GitHub Actions locally with act. Use when a user asks to test GitHub Actions workflows locally, debug CI pipelines without pushing, or run workflows offline.

TerminalSkills/skills

>- You are an expert in AG2 (formerly AutoGen), the open-source multi-agent conversation framework. You help developers build systems where multiple AI agents collaborate through structured conversations — with tool use, human-in-the-loop, code execution, group chat orchestration, and nested conversations — for complex tasks like software development, research, and data analysis.

TerminalSkills/skills

>- Generate short-form videos with AI — script writing, text-to-speech narration, stock footage selection, subtitle generation, and video assembly. Use when: creating TikTok/YouTube Shorts/Reels content, automating video production, building content pipelines.

TerminalSkills/skills

>- Animate 3D objects and characters in Blender with Python. Use when the user wants to keyframe properties, create armatures and rigs, set up IK/FK chains, animate shape keys for facial animation, edit F-Curves, use the NLA editor to blend actions, add drivers for expression-based animation, or script any animation workflow in Blender.

TerminalSkills/skills

>- Automate motion capture and tracking workflows in Blender with Python. Use when the user wants to import BVH or FBX mocap data, retarget motion to armatures, track camera or object motion from video, solve camera motion, clean up motion capture data, or script any tracking pipeline in Blender.

TerminalSkills/skills

>- You are an expert in Bolt.new by StackBlitz, the AI-powered full-stack development environment that runs entirely in the browser. You help developers go from idea to deployed app in minutes using natural language prompts — Bolt generates complete applications with frontend, backend, database, and deployment, all running in a WebContainer without local setup.

TerminalSkills/skills

>- Assists with using Bun as an all-in-one JavaScript/TypeScript runtime, package manager, bundler, and test runner. Use when building HTTP servers, managing packages, running tests, or migrating from Node.js. Trigger words: bun, bun serve, bun install, bun test, bun build, javascript runtime, bun runtime.

TerminalSkills/skills

>- Self-host customer support with Chatwoot. Use when a user asks to set up open-source customer support, add live chat without SaaS costs, build a multi-channel inbox, or deploy a free Intercom alternative.

TerminalSkills/skills

>- You are an expert in Chi, the lightweight, idiomatic Go HTTP router built on `net/http`. You help developers build composable HTTP services using Chi's middleware stack, route groups, URL parameters, sub-routers, and context-based request scoping — providing Express-like ergonomics while staying 100% compatible with Go's standard library.

TerminalSkills/skills

When the user wants to edit, review, or improve existing marketing copy. Also use when the user mentions 'edit this copy,' 'review my copy,' 'copy feedback,' 'proofread,' 'polish this,' 'make this better,' or 'copy sweep.' This skill provides a systematic approach to editing marketing copy through multiple focused passes.

TerminalSkills/skills

>- Add live chat and customer support with Crisp. Use when a user asks to add a chat widget, implement live customer support, set up a help desk, create a knowledge base, or add a chatbot to a website.

TerminalSkills/skills

>- Assists with building custom interactive data visualizations using D3.js. Use when creating charts, graphs, maps, force layouts, or hierarchical diagrams that require fine-grained control beyond what charting libraries provide. Trigger words: d3, data visualization, chart, svg, scales, force graph, treemap, choropleth.

TerminalSkills/skills

dbt (data build tool) transforms data in your warehouse using SQL SELECT statements. Learn project setup, models, tests, documentation, incremental materializations, and integration with data warehouses like PostgreSQL, BigQuery, and Snowflake.

TerminalSkills/skills

>- You are an expert in dlt, the open-source Python library for building data pipelines. You help developers load data from any API, file, or database into warehouses and lakes using simple Python decorators — with automatic schema inference, incremental loading, and built-in data contracts. dlt is the "requests library for data pipelines.

TerminalSkills/skills

Data Version Control for ML projects. Track large datasets and models alongside Git, build reproducible ML pipelines, and run experiments with metric comparison. Works with any storage backend including S3, GCS, Azure, and local filesystems.

TerminalSkills/skills

>- You are an expert in E2B, the cloud platform for running AI-generated code in secure sandboxes. You help developers give AI agents the ability to execute code, install packages, read/write files, and run long processes in isolated cloud environments — each sandbox is a lightweight VM that boots in ~150ms with full Linux, filesystem, and networking.

TerminalSkills/skills

>- Transcode, convert, edit, and process audio and video with FFmpeg. Use when a user asks to convert video formats (webm to mp4, mkv to mp4), extract audio from video, compress video files, trim or cut clips, concatenate videos, add subtitles, create thumbnails, apply filters, change resolution or bitrate, re-encode media, create GIFs from video, add watermarks, normalize audio, stream media, or build automated media processing pipelines.

TerminalSkills/skills

>- Create advanced animations with GSAP. Use when building complex timelines, scroll-driven animations, SVG morphing, text animations, or high-performance web animations beyond CSS capabilities.

TerminalSkills/skills

When the user wants to perform load testing, stress testing, or performance testing of APIs and websites using k6. Also use when the user mentions "k6," "load test," "performance test," "stress test," "spike test," "soak test," "thresholds," "virtual users," or "VUs." For browser-based testing, see selenium.

TerminalSkills/skills

>- Lovable (formerly GPT Engineer) is a browser-based AI app builder that turns a natural-language description into a working full-stack web app with a built-in backend, authentication, database and one-click publishing. Use when the user wants to prototype or ship a web app with Lovable, write effective Lovable prompts, connect Supabase or GitHub, review generated security rules, or move a Lovable project into their own editor.

Habilidades Relacionadas