Communitygithub.com

libz-renlab-ai/TeamBrain

Crea composiciones de video, animaciones, tarjetas de título, superposiciones, subtítulos, locuciones, visuales reactivos al audio y transiciones de escena en HyperFrames HTML.

¿Qué es TeamBrain?

Este skill permite generar y editar composiciones de video completas utilizando HTML como fuente de verdad. El flujo de trabajo se divide en etapas: primero se establece un sistema de diseño basado en un archivo `design.md` (o se ofrecen alternativas como paletas predefinidas o un selector visual), luego se expande la intención del usuario según las guías de estilo y composición, y finalmente se planifica la estructura, el ritmo y la animación de la pieza. Es especialmente útil para crear contenido como lanzamientos de productos, videos para redes sociales, tarjetas de título animadas, subtítulos sincronizados con audio, visuales reactivos a la música (beat sync, glow, pulse) y transiciones entre escenas (crossfades, wipes, reveals, shaders). El skill está diseñado para plataformas como HyperFrames y puede integrarse con herramientas CLI como `init`, `lint`, `preview`, `render`, `transcribe` y `tts`. Su enfoque metódico —diseño primero, layout estático después, luego animación— y sus reglas estrictas (sin `Math.random()`, sin `repeat: -1`, timelines síncronas) garantizan resultados predecibles y de alta calidad.

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

Preguntar en tu IA favorita

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

Vista previa

Del README del skill

Documentación

HyperFrames

HTML es la fuente de verdad para el video. Una composición es un archivo HTML con atributos data-* para el tiempo, una línea de tiempo de GSAP para la animación y CSS para la apariencia. El framework maneja la visibilidad de los clips, la reproducción de medios y la sincronización de la línea de tiempo.

Enfoque

Descubrimiento (solo para solicitudes exploratorias)

Para solicitudes abiertas ("hazme un video de lanzamiento de producto", "crea algo para nuestra marca") donde el usuario no se ha comprometido con una dirección, comprende la intención antes de elegir colores:

  • Audiencia — ¿quién ve esto? ¿Desarrolladores? ¿Ejecutivos? ¿Consumidores generales?
  • Plataforma — ¿dónde se reproduce? ¿Redes sociales (15s), sitio web hero, demo de producto, interno?
  • Prioridad — ¿qué es lo más importante? ¿Calidad de movimiento? ¿Precisión del contenido? ¿Fidelidad de marca? ¿Velocidad?
  • Variaciones — ¿el usuario quiere opciones o una sola mejor toma?

Para solicitudes específicas ("agrega una tarjeta de título", "arregla el tiempo en la escena 3"), omite el descubrimiento.

Para solicitudes exploratorias, considera ofrecer 2-3 variaciones que difieran significativamente — no solo cambios de color, sino diferente ritmo, niveles de energía o enfoques estructurales. Una segura/esperada, una ambiciosa. No lo mandes — es una herramienta disponible cuando sea apropiado.

Paso 1: Sistema de diseño

Si existe design.md o DESIGN.md en el proyecto, léelo primero (verifica ambas mayúsculas/minúsculas — son archivos diferentes en Linux). Es la fuente de verdad para colores de marca, fuentes y restricciones. Usa sus valores exactos — no inventes colores ni sustituyas fuentes. Cualquier formato funciona (frontmatter YAML, prosa, tablas — solo extrae los valores).

Si nombra fuentes que no puedes encontrar localmente (sin directorio fonts/ con archivos .woff2, no es una fuente incorporada), advierte al usuario antes de escribir HTML: "design.md especifica [nombre de fuente] pero no se encontraron archivos de fuente. Agrega archivos .woff2 a fonts/ o usaré [alternativa incorporada más cercana] como respaldo."

Si no existe design.md, ofrece al usuario una opción:

  1. ¿El usuario nombró un estilo o estado de ánimo? → Lee visual-styles.md para los 8 preajustes nombrados. Elige la coincidencia más cercana.
  2. ¿Quieres explorar opciones visualmente? → Ejecuta el selector de diseño: lee references/design-picker.md para el flujo de trabajo completo. Esto sirve una página de selector visual. El usuario configura el estado de ánimo, la paleta, la tipografía y el movimiento en el navegador, luego copia el design.md generado y lo pega de nuevo en la conversación.
  3. ¿Quieres omitir e ir rápido? → Pregunta: estado de ánimo, claro u oscuro, ¿colores/fuentes de marca? Luego elige una paleta de house-style.md.

design.md define la marca. No define las reglas de composición de video. Esas vienen de references/video-composition.md y house-style.md. Usa colores de marca a escala apropiada para video — no a opacidad de interfaz web.

Paso 2: Expansión de la indicación

Siempre ejecuta en cada composición (excepto piezas de una sola escena y ediciones triviales). Este paso fundamenta la intención del usuario contra design.md y house-style.md y produce un intermediario consistente que cada agente posterior lee de la misma manera.

Lee references/prompt-expansion.md para el proceso completo y el formato de salida.

Paso 3: Planificar

Antes de escribir HTML, piensa a alto nivel:

  1. Qué — ¿qué debería experimentar el espectador? Identifica el arco narrativo, los momentos clave y los latidos emocionales.
  2. Estructura — cuántas composiciones, cuáles son sub-composiciones vs en línea, qué pistas llevan qué (video, audio, superposiciones, subtítulos).
  3. Ritmo — declara tu ritmo de escena antes de implementar. Qué escenas son impactos rápidos, cuáles son pausas, dónde caen los shaders, dónde alcanza el pico de energía. Nombra el patrón: rápido-rápido-LENTO-rápido-SHADER-pausa. Lee references/beat-direction.md para plantillas de ritmo.
  4. Tiempo — qué clips impulsan la duración, dónde caen las transiciones, cuál es el ritmo.
  5. Disposición — construye el estado final primero. Ver "Disposición antes de animación" más abajo.
  6. Animar — luego agrega movimiento usando las reglas a continuación.

Construye lo que se pidió. Una solicitud de "una tarjeta de título" no es una solicitud de "una tarjeta de título + 3 escenas de apoyo + música ambiental + subtítulos." Cada escena, cada elemento, cada interpolación debe ganarse su lugar. Si escenas o elementos adicionales mejoraran genuinamente la pieza, propónlos — no los agregues.

Para ediciones pequeñas (corregir un color, ajustar el tiempo, agregar un elemento), ve directamente a las reglas.

Disposición antes de animación

Posiciona cada elemento donde debería estar en su momento más visible — el fotograma en el que ha entrado completamente, está colocado correctamente y aún no está saliendo. Escríbelo primero como HTML+CSS estático. Aún no hay GSAP.

Por qué esto importa: Si posicionas elementos en su estado de inicio animado (fuera de pantalla, escalados a 0, opacidad 0) y los interpolas a donde crees que deberían aterrizar, estás adivinando la disposición final. Las superposiciones son invisibles hasta que el video se renderiza. Al construir el estado final primero, puedes ver y corregir problemas de disposición antes de agregar cualquier movimiento.

El proceso

  1. Identifica el fotograma héroe para cada escena — el momento en que la mayoría de los elementos son visibles simultáneamente. Esta es la disposición que construyes.
  2. Escribe CSS estático para ese fotograma. El contenedor .scene-content DEBE llenar la escena completa usando width: 100%; height: 100%; padding: Npx; con display: flex; flex-direction: column; gap: Npx; box-sizing: border-box. Usa padding para empujar el contenido hacia adentro — NUNCA uses position: absolute; top: Npx en un contenedor de contenido. Los contenedores de contenido con posicionamiento absoluto se desbordan cuando el contenido es más alto que el espacio restante. Reserva position: absolute solo para elementos decorativos.
  3. Agrega entradas con gsap.from() — anima DESDE fuera de pantalla/invisible HASTA la posición CSS. La posición CSS es la verdad fundamental; la interpolación describe el viaje para llegar allí. (En sub-composiciones cargadas a través de data-composition-src, prefiere gsap.fromTo() — consulta las reglas de GSAP de carga en references/motion-principles.md).
  4. Agrega salidas con gsap.to() — anima HASTA fuera de pantalla/invisible DESDE la posición CSS.

Ejemplo

/* scene-content llena la escena, padding posiciona el contenido */
.scene-content {
  display: flex;
  flex-direction: column;
  justify-content: center;
  width: 100%;
  height: 100%;
  padding: 120px 160px;
  gap: 24px;
  box-sizing: border-box;
}
.title {
  font-size: 120px;
}
.subtitle {
  font-size: 42px;
}
/* El contenedor llena cualquier tamaño de escena (1920x1080, 1080x1920, etc.).
   El padding posiciona el contenido. Flex + gap maneja el espaciado. */

INCORRECTO — dimensiones codificadas y posicionamiento absoluto:

.scene-content {
  position: absolute;
  top: 200px;
  left: 160px;
  width: 1920px;
  height: 1080px;
  display: flex; /* ... */
}
// Paso 3: Animar HACIA esas posiciones
tl.from(".title", { y: 60, opacity: 0, duration: 0.6, ease: "power3.out" }, 0);
tl.from(".subtitle", { y: 40, opacity: 0, duration: 0.5, ease: "power3.out" }, 0.2);
tl.from(".logo", { scale: 0.8, opacity: 0, duration: 0.4, ease: "power2.out" }, 0.3);

// Paso 4: Animar FUERA de esas posiciones
tl.to(".title", { y: -40, opacity: 0, duration: 0.4, ease: "power2.in" }, 3);
tl.to(".subtitle", { y: -30, opacity: 0, duration: 0.3, ease: "power2.in" }, 3.1);
tl.to(".logo", { scale: 0.9, opacity: 0, duration: 0.3, ease: "power2.in" }, 3.2);

Cuando los elementos comparten espacio a través del tiempo

Si el elemento A sale antes de que el elemento B entre en la misma área, ambos deben tener posiciones CSS correctas para sus respectivos fotogramas héroe. El orden de la línea de tiempo garantiza que nunca coexistan visualmente — pero si omites el paso de disposición, no detectarás el caso en que se superponen accidentalmente debido a un error de tiempo.

Qué cuenta como superposición intencional

Los efectos en capas (brillo detrás del texto, elementos de sombra, patrones de fondo) y los diseños apilados en z (pilas de tarjetas, capas de profundidad) son intencionales. El paso de disposición se trata de detectar superposiciones no intencionales — dos títulos que aterrizan uno encima del otro, una estadística que cubre una etiqueta, contenido que se sale del fotograma.

Atributos de Datos

Todos los Clips

AtributoRequeridoValores
idSíIdentificador único
data-startSíSegundos o referencia de ID de clip ("el-1", "intro + 2")
data-durationRequerido para img/div/composicionesSegundos. Video/audio usa la duración del medio por defecto.
data-track-indexSíEntero. Los clips de la misma pista no pueden superponerse.
data-media-startNoDesplazamiento de recorte en la fuente (segundos)
data-volumeNo0-1 (por defecto 1)

data-track-index no afecta la superposición visual — usa CSS z-index.

Clips de Composición

AtributoRequeridoValores
data-composition-idSíID de composición único
data-startSíTiempo de inicio (composición raíz: usa "0")
data-durationSíTiene prioridad sobre la duración de la línea de tiempo de GSAP
data-width / data-heightSíDimensiones en píxeles (1920x1080 o 1080x1920)
data-composition-srcNoRuta al archivo HTML externo

Estructura de Composición

Las sub-composiciones cargadas a través de data-composition-src usan un envoltorio <template>. Las composiciones independientes (el archivo index.html principal) NO usan <template> — colocan el div con data-composition-id directamente en <body>. Usar <template> en un archivo independiente oculta todo el contenido del navegador y rompe el renderizado.

Estructura de sub-composición:

<template id="my-comp-template">
  <div data-composition-id="my-comp" data-width="1920" data-height="1080">
    <!-- contenido -->
    <style>
      [data-composition-id="my-comp"] {
        /* estilos encapsulados */
      }
    </style>
    <script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/gsap.min.js"></script>
    <script>
      window.__timelines = window.__timelines || {};
      const tl = gsap.timeline({ paused: true });
      // interpolaciones...
      window.__timelines["my-comp"] = tl;
    </script>
  </div>
</template>

Cargar en raíz: <div id="el-1" data-composition-id="my-comp" data-composition-src="compositions/my-comp.html" data-start="0" data-duration="10" data-track-index="1"></div>

Video y Audio

El video debe estar muted playsinline. El audio siempre es un elemento <audio> separado:

<video
  id="el-v"
  data-start="0"
  data-duration="30"
  data-track-index="0"
  src="video.mp4"
  muted
  playsinline
></video>
<audio
  id="el-a"
  data-start="0"
  data-duration="30"
  data-track-index="2"
  src="video.mp4"
  data-volume="1"
></audio>

Contrato de Línea de Tiempo

  • Todas las líneas de tiempo comienzan { paused: true } — el jugador controla la reproducción
  • Registra cada línea de tiempo: window.__timelines["<composition-id>"] = tl
  • El framework anida automáticamente sub-líneas de tiempo — NO las agregues manualmente
  • La duración proviene de data-duration, no de la longitud de la línea de tiempo de GSAP
  • Nunca crees interpolaciones vacías para establecer la duración

Reglas (No Negociables)

Determinista: Sin Math.random(), Date.now() o lógica basada en tiempo. Usa un PRNG con semilla si necesitas valores pseudoaleatorios (por ejemplo, mulberry32).

GSAP: Solo anima propiedades visuales (opacity, x, y, scale, rotation, color, backgroundColor, borderRadius, transformaciones). NO animes visibility, display ni llames a video.play()/audio.play().

Conflictos de animación: Nunca animes la misma propiedad en el mismo elemento desde múltiples líneas de tiempo simultáneamente.

Sin repeat: -1: Las líneas de tiempo con repetición infinita rompen el motor de captura. Calcula el número exacto de repeticiones a partir de la duración de la composición: repeat: Math.ceil(duration / cycleDuration) - 1.

Construcción síncrona de líneas de tiempo: Nunca construyas líneas de tiempo dentro de async/await, setTimeout o Promesas. El motor de captura lee window.__timelines de forma síncrona después de cargar la página. Las fuentes están incrustadas por el compilador, por lo que están disponibles inmediatamente — no es necesario esperar a que se carguen las fuentes.

Nunca hagas:

  1. Olvidar el registro de window.__timelines
  2. Usar video para audio — siempre video muteado + <audio> separado
  3. Anidar video dentro de un div con tiempo — usa un envoltorio sin tiempo
  4. Usar data-layer (usa data-track-index) o data-end (usa data-duration)
  5. Animar las dimensiones del elemento de video — anima un div envoltorio
  6. Llamar a play/pause/seek en medios — el framework posee la reproducción
  7. Crear un contenedor de nivel superior sin data-composition-id
  8. Usar repeat: -1 en cualquier línea de tiempo o interpolación — siempre repeticiones finitas
  9. Construir líneas de tiempo de forma asíncrona (dentro de async, setTimeout, Promise)
  10. Usar gsap.set() en elementos de clip de escenas posteriores — no existen en el DOM al cargar la página. Usa tl.set(selector, vars, timePosition) dentro de la línea de tiempo en o después del tiempo data-start del clip.
  11. Usar <br> en texto de contenido — los saltos de línea forzados no tienen en cuenta el ancho real de la fuente renderizada. El texto que se ajusta de forma natural + un <br> produce un salto extra no deseado, causando superposición. Deja que el texto se ajuste a través de max-width. Excepción: títulos cortos donde cada palabra está deliberadamente en su propia línea (por ejemplo, "THE\nIMMORTAL\nGAME" a 130px).

Transiciones de Escena (No Negociables)

Toda composición de múltiples escenas DEBE seguir TODAS estas reglas. Violar cualquiera de ellas es una composición rota.

  1. **

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

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

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