Communitygithub.com

libz-renlab-ai/TeamBrain

Instala y conecta bloques y componentes del registro en composiciones HyperFrames. Úsalo al ejecutar hyperframes add, instalar un bloque o componente, conectar un elemento instalado en index.html, o trabajar con hyperframes.json. Cubre el comando add, ubicaciones de instalación, conexión de subcomposiciones de bloques, fusión de fragmentos de componentes y descubrimiento del registro.

¿Qué es TeamBrain?

Esta habilidad permite a un agente de IA (como Claude Code, Cursor o Codex) gestionar el registro de HyperFrames, un sistema modular para crear composiciones de video interactivas. Proporciona instrucciones precisas para instalar bloques (subcomposiciones independientes con sus propias dimensiones y línea de tiempo) y componentes (fragmentos de efectos sin dimensiones propias) usando el comando `hyperframes add`. La habilidad detalla cómo conectar estos elementos en un archivo `index.html` anfitrión, especificando atributos clave como `data-composition-id`, `data-start` y `data-track-index` para los bloques, o fusionando HTML, CSS y JS para los componentes. También cubre la configuración de rutas de instalación mediante `hyperframes.json`, el descubrimiento de elementos disponibles en el registro a través de su manifiesto y referencias a documentación especializada. Es útil para desarrolladores que trabajan con HyperFrames y necesitan asistencia automatizada para instalar y cablear componentes reutilizables de manera eficiente.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Registro de HyperFrames

El registro proporciona bloques y componentes reutilizables instalables mediante hyperframes add <nombre>.

  • Bloques — subcomposiciones independientes (dimensiones, duración, línea de tiempo propias). Se incluyen mediante data-composition-src en una composición anfitriona.
  • Componentes — fragmentos de efectos (sin dimensiones propias). Se pegan directamente en el HTML de la composición anfitriona.

Cuándo usar esta habilidad

  • El usuario menciona hyperframes add, "bloque", "componente" o hyperframes.json
  • Aparece la salida de hyperframes add en la sesión (rutas de archivo, fragmento en el portapapeles)
  • Necesitas conectar un elemento instalado en una composición existente
  • Deseas descubrir qué hay disponible en el registro

Referencia rápida

hyperframes add data-chart              # instalar un bloque
hyperframes add grain-overlay           # instalar un componente
hyperframes add shimmer-sweep --dir .   # apuntar a un proyecto específico
hyperframes add data-chart --json       # salida legible por máquina
hyperframes add data-chart --no-clipboard  # omitir portapapeles (CI/headless)

Después de la instalación, la CLI imprime qué archivos se escribieron y un fragmento para pegar en tu composición anfitriona. El fragmento es un punto de partida: deberás añadir los atributos data-composition-id (debe coincidir con el ID interno del bloque), data-start y data-track-index al conectar bloques.

Nota: hyperframes add solo funciona para bloques y componentes. Para ejemplos, usa hyperframes init <dir> --example <nombre>.

Ubicaciones de instalación

Los bloques se instalan en compositions/<nombre>.html por defecto. Los componentes se instalan en compositions/components/<nombre>.html por defecto.

Estas rutas son configurables en hyperframes.json:

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

Consulta install-locations.md para más detalles.

Conexión de bloques

Los bloques son composiciones independientes — inclúyelos mediante data-composition-src en tu index.html anfitrión:

<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 clave:

  • data-composition-src — ruta al archivo HTML del bloque
  • data-composition-id — debe coincidir con el ID interno del bloque
  • data-start — momento en que aparece el bloque en la línea de tiempo anfitriona (segundos)
  • data-duration — duración de reproducción del bloque
  • data-width / data-height — dimensiones del lienzo del bloque
  • data-track-index — orden de capas (mayor = al frente)

Consulta wiring-blocks.md para más detalles.

Conexión de componentes

Los componentes son fragmentos — pega su HTML en el marcado de tu composición, su CSS en tu bloque de estilos y su JS en tu script (si lo hay):

  1. Lee el archivo instalado (ej., compositions/components/grain-overlay.html)
  2. Copia los elementos HTML dentro del <div data-composition-id="..."> de tu composición
  3. Copia el bloque <style> en los estilos de tu composición
  4. Copia cualquier contenido <script> en el script de tu composición (antes del código de línea de tiempo)
  5. Si el componente expone integración con la línea de tiempo de GSAP (consulta el bloque de comentarios en el fragmento), agrega esas llamadas a tu línea de tiempo

Consulta wiring-components.md para más detalles.

Descubrimiento

Navega por los elementos disponibles:

# Leer el manifiesto del registro
curl -s https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry/registry.json

Cada registry-item.json de un elemento contiene: nombre, tipo, título, descripción, etiquetas, dimensiones (solo bloques), duración (solo bloques) y lista de archivos.

Consulta discovery.md para detalles sobre filtrado por tipo y etiquetas.

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.

Skills relacionados