Communitygithub.com

libz-renlab-ai/TeamBrain

Instalar e conectar blocos e componentes do registro em composições HyperFrames. Use ao executar hyperframes add, instalar um bloco ou componente, conectar um item instalado em index.html ou trabalhar com hyperframes.json. Abrange o comando add, locais de instalação, conexão de sub-composição de blocos, mesclagem de snippets de componentes e descoberta do registro.

O que é TeamBrain?

Esta skill do agente lida com o registro HyperFrames, que fornece blocos e componentes reutilizáveis. Ela é ativada quando o usuário menciona `hyperframes add`, "bloco", "componente" ou `hyperframes.json`, ou quando a saída do comando aparece na sessão. A skill permite instalar blocos (sub-composições independentes com suas próprias dimensões, duração e timeline) e componentes (snippets de efeito sem dimensões próprias). Ela cobre o processo completo: desde a instalação via `hyperframes add`, passando pela configuração de caminhos em `hyperframes.json`, até a conexão dos itens instalados em uma composição existente. Para blocos, ela orienta a inclusão via `data-composition-src` com atributos como `data-composition-id`, `data-start` e `data-track-index`. Para componentes, explica como copiar o HTML, CSS e JS do snippet para o arquivo da composição anfitriã. Por fim, ensina a descobrir itens disponíveis lendo o manifesto do registro com curl. É útil para desenvolvedores que trabalham com o framework HyperFrames, especialmente em projetos de timeline animada baseados em composições.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/libz-renlab-ai/TeamBrain/tree/HEAD/.agents/skills/hyperframes-registry

Perguntar na sua IA favorita

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

Documentação

Registro HyperFrames

O registro fornece blocos e componentes reutilizáveis instaláveis via hyperframes add <nome>.

  • Blocos — sub-composições independentes (próprias dimensões, duração, timeline). Incluídos via data-composition-src em uma composição anfitriã.
  • Componentes — snippets de efeito (sem dimensões próprias). Colados diretamente no HTML de uma composição anfitriã.

Quando usar esta skill

  • O usuário menciona hyperframes add, "bloco", "componente" ou hyperframes.json
  • A saída de hyperframes add aparece na sessão (caminhos de arquivo, snippet da área de transferência)
  • Você precisa conectar um item instalado a uma composição existente
  • Você deseja descobrir o que está disponível no registro

Referência rápida

hyperframes add data-chart              # instalar um bloco
hyperframes add grain-overlay           # instalar um componente
hyperframes add shimmer-sweep --dir .   # direcionar um projeto específico
hyperframes add data-chart --json       # saída legível por máquina
hyperframes add data-chart --no-clipboard  # pular área de transferência (CI/headless)

Após a instalação, a CLI imprime quais arquivos foram escritos e um snippet para colar em sua composição anfitriã. O snippet é um ponto de partida — você precisará adicionar os atributos data-composition-id (deve corresponder ao ID interno da composição do bloco), data-start e data-track-index ao conectar blocos.

Nota: hyperframes add funciona apenas para blocos e componentes. Para exemplos, use hyperframes init <dir> --example <nome>.

Locais de instalação

Blocos são instalados em compositions/<nome>.html por padrão. Componentes são instalados em compositions/components/<nome>.html por padrão.

Esses caminhos são configuráveis em hyperframes.json:

{
  "registry": "https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry",
  "paths": {
    "blocks": "compositions",
    "components": "compositions/components",
    "assets": "assets"
  }
}

Consulte install-locations.md para detalhes completos.

Conectando blocos

Blocos são composições independentes — inclua-os via data-composition-src em seu index.html anfitrião:

<div
  data-composition-id="data-chart"
  data-composition-src="compositions/data-chart.html"
  data-start="2"
  data-duration="15"
  data-track-index="1"
  data-width="1920"
  data-height="1080"
></div>

Atributos principais:

  • data-composition-src — caminho para o arquivo HTML do bloco
  • data-composition-id — deve corresponder ao ID interno do bloco
  • data-start — quando o bloco aparece na timeline anfitriã (segundos)
  • data-duration — por quanto tempo o bloco é reproduzido
  • data-width / data-height — dimensões da tela do bloco
  • data-track-index — ordem de camadas (maior = na frente)

Consulte wiring-blocks.md para detalhes completos.

Conectando componentes

Componentes são snippets — cole seu HTML na marcação da sua composição, seu CSS no bloco de estilo e seu JS no script (se houver):

  1. Leia o arquivo instalado (ex., compositions/components/grain-overlay.html)
  2. Copie os elementos HTML para o <div data-composition-id="..."> da sua composição
  3. Copie o bloco <style> para os estilos da sua composição
  4. Copie qualquer conteúdo <script> para o script da sua composição (antes do código da timeline)
  5. Se o componente expuser integração com timeline GSAP (veja o bloco de comentário no snippet), adicione essas chamadas à sua timeline

Consulte wiring-components.md para detalhes completos.

Descoberta

Navegue pelos itens disponíveis:

# Leia o manifesto do registro
curl -s https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry/registry.json

Cada registry-item.json contém: nome, tipo, título, descrição, tags, dimensões (apenas blocos), duração (apenas blocos) e lista de arquivos.

Consulte discovery.md para detalhes sobre filtragem por tipo e tags.

Individual skills in this repo

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

libz-renlab-ai/TeamBrain

Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.

libz-renlab-ai/TeamBrain

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For CLI commands (init, lint, preview, render, transcribe, tts) see the hyperframes-cli skill.

libz-renlab-ai/TeamBrain

Translate an existing Remotion (React-based) video composition into a HyperFrames HTML composition. Use ONLY when the user explicitly asks to port, convert, migrate, translate, or rewrite a Remotion composition as HyperFrames — for example "port my Remotion project to HyperFrames", "convert this Remotion code to HyperFrames", "migrate from Remotion", "translate this Remotion comp", or "rewrite this as HyperFrames HTML". Do NOT use when (a) the user is authoring a NEW HyperFrames composition, even if they have or are A/B-testing a similar Remotion video; (b) the user mentions Remotion in passing without asking for migration; (c) the user shares Remotion code as reference material rather than asking for a translation; (d) the user asks for "the same video as my Remotion one" without explicitly asking to migrate the source — treat that as a fresh HyperFrames build. When in doubt, default to authoring a native HyperFrames composition with the `hyperframes` skill instead. Skill detects unsupported patterns (use...

libz-renlab-ai/TeamBrain

Capture a website and create a HyperFrames video from it. Use when: (1) a user provides a URL and wants a video, (2) someone says "capture this site", "turn this into a video", "make a promo from my site", (3) the user wants a social ad, product tour, or any video based on an existing website, (4) the user shares a link and asks for any kind of video content. Even if the user just pastes a URL — this is the skill to use.

libz-renlab-ai/TeamBrain

HyperFrames CLI tool — hyperframes init, lint, inspect, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. Use when scaffolding a project, linting, validating, inspecting visual layout in compositions, previewing in the studio, rendering to video, transcribing audio, generating TTS, or troubleshooting the HyperFrames environment.

Habilidades Relacionadas