Communitygithub.com

Aurora-AI/Mad-Lab-Aurora

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

¿Qué es Mad-Lab-Aurora?

Esta habilidad convierte a un agente de IA en un asistente de producción de video completo utilizando HyperFrames, un marco que trata el HTML como fuente de verdad para la composición de video. Permite generar composiciones HTML completas con atributos `data-*` para sincronización temporal, animaciones GSAP y estilo CSS, cubriendo flujos de trabajo desde la creación de storyboards hasta el renderizado final. Su utilidad principal radica en agilizar la creación de contenido de video complejo, como videos de productos, demostraciones o clips para redes sociales, evitando la tediosa edición manual de línea de tiempo. Soporta plataformas que ejecutan agentes como Claude Code, Cursor y Codex, y se integra de manera óptima con Open Design (OD) para un flujo de trabajo de renderizado rápido y no obstructivo. El agente, siguiendo las instrucciones de SKILL.md, construye el estado final del diseño visual primero (usando CSS estático), luego agrega animaciones de entrada y salida con GSAP, y maneja tareas especializadas como la generación de subtítulos sincronizados, texto a voz y transiciones de escena. Para proyectos dentro de Open Design, utiliza una ruta rápida de andamio (`hyperframes init`) y envía el renderizado a un proceso daemon para evitar problemas de sandbox, mientras que para proyectos independientes, aplica una estricta puerta de identidad visual para garantizar un diseño coherente desde el principio.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Aurora-AI/Mad-Lab-Aurora/tree/HEAD/integrations/open-design/skills/hyperframes

Preguntar en tu IA favorita

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

Documentación

HyperFrames

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

Integración con Open Design (esencial para esta superficie)

Cuando esta habilidad se ejecuta dentro de Open Design (es decir, $OD_PROJECT_DIR está definido), el flujo de salida es fijo: solo el .mp4 renderizado debe colocarse en la raíz del proyecto. Los archivos fuente de la composición (hyperframes.json, meta.json, index.html, assets) pertenecen a un directorio de caché oculto para no saturar el Visor de Archivos del usuario ni los "archivos producidos" del chat.

Flujo de trabajo de renderizado dentro de OD — ruta rápida:

Para la mayoría de las solicitudes de OD ("video de prueba", "presentación de producto de 5s", "clip de demostración"), NO escribas la composición HTML desde cero. Utiliza el andamio integrado de HyperFrames y edita solo lo que el prompt realmente cambia. La ruta de "autor desde cero" cuesta minutos de salida del modelo y tiempo de herramienta de chat silenciosa; la ruta de andamio cuesta segundos.

# 1. Elige una ranura de caché oculta. El prefijo de punto (.) hace que OD
#    ignore el archivo en la lista de archivos del proyecto, por lo que los
#    archivos fuente nunca saturan el chat.
COMP_REL=".hyperframes-cache/$(date +%s)-$(openssl rand -hex 2)"
COMP="$OD_PROJECT_DIR/$COMP_REL"

# 2. Obtén un andamio inmediatamente renderizable (hyperframes.json,
#    meta.json, index.html con CDN de GSAP + window.__timelines.main
#    ya registrado). Esto se ejecuta en tu shell — copia de archivos pura,
#    sin Chrome, sin red más allá del caché de npx.
npx hyperframes init "$COMP" --example blank --skip-skills --non-interactive

# 3. Edita SOLO $COMP/index.html — cambia `data-duration` en la raíz
#    si necesitas una duración no predeterminada, reemplaza la paleta
#    de marcador de posición en <style>, agrega 1–3 clips <div> para
#    texto/imágenes, y agrega los tweens de GSAP correspondientes dentro
#    del bloque existente de
#    `window.__timelines["main"] = gsap.timeline({paused:true})`.
#    Mantén las ediciones mínimas; el andamio ya es HF válido.

# 4. Envía el renderizado a través del daemon de OD. NO ejecutes `npx hyperframes
#    render` desde este shell — el daemon lo ejecuta por ti en un proceso
#    sin sandbox. (Muchos CLI de agentes, Claude Code en particular,
#    envuelven Bash en el sandbox-exec de macOS, bajo el cual el subproceso
#    de Chrome de Puppeteer se cuelga a mitad de la captura de fotogramas.
#    El proceso del daemon no tiene sandbox, por lo que los renderizados
#    se completan de manera confiable.)
#
#    El despachador devuelve en ~1s con un {taskId}; impulsa el
#    renderizado hasta su finalización con un bucle de llamadas
#    `"$OD_NODE_BIN" "$OD_BIN" media wait <taskId>`.
#    Cada llamada realiza una espera larga de hasta 25s (muy por debajo del
#    límite predeterminado de 30s de tu herramienta de shell) y sale con
#    0/2/5 para indicar hecho/ejecutando/fallido.
out=$("$OD_NODE_BIN" "$OD_BIN" media generate \
  --project "$OD_PROJECT_ID" \
  --surface video \
  --model hyperframes-html \
  --output "<descriptive-name>.mp4" \
  --composition-dir "$COMP_REL")
ec=$?
task_id=$(printf '%s\n' "$out" | tail -1 | jq -r '.taskId // empty')
since=$(printf '%s\n' "$out" | tail -1 | jq -r '.nextSince // 0')
while [ "$ec" -eq 2 ] && [ -n "$task_id" ]; do
  out=$("$OD_NODE_BIN" "$OD_BIN" media wait "$task_id" --since "$since")
  ec=$?
  since=$(printf '%s\n' "$out" | tail -1 | jq -r '.nextSince // '"$since")
done
[ "$ec" -ne 0 ] && { echo "$out" >&2; exit "$ec"; }

Cada llamada generate y cada wait duran como máximo ~25s, por lo que el límite predeterminado de ~30s de la herramienta de shell del agente nunca se activa. Las líneas de progreso de HF (Capturing frame N/M) se transmiten a stderr en vivo durante todo el bucle. Cuando el renderizado finaliza, la última línea de stdout es {"file": { "name": "<output>", "size": …, "kind": "video", … }} — cita file.name en tu respuesta para que el usuario sepa qué se produjo.

Omite la Puerta de Identidad Visual dentro de OD. La sección HARD-GATE a continuación (bajo "Enfoque") te indica que leas DESIGN.md / visual-style.md o te detengas y hagas 3 preguntas de estado de ánimo antes de escribir cualquier composición. Esa puerta es para proyectos HF independientes. Los proyectos OD ya tienen su propia capa de sistema de diseño — el usuario eligió su dirección visual al crear el proyecto. Para un renderizado de prueba de OD, usa por defecto: lienzo oscuro (#0b0b0f), un acento cálido (#ffb76b), un acento frío (#7da4ff), movimiento moderado. Solo pide información estilística si el prompt del usuario es demasiado vago para siquiera elegir un tema (muy raro).

Cuándo omitir el andamio y escribir desde cero: solo cuando el usuario solicita explícitamente algo que la plantilla en blanco claramente no puede alojar (por ejemplo, líneas de tiempo de múltiples composiciones, superposiciones reactivas al audio, subtítulos sincronizados con una pista de TTS que ya han generado). Para todo lo demás, la ruta predeterminada es init + editar.

Los subcomandos de HF más ligeros que SÍ puedes ejecutar desde tu propio shell (no necesitan lanzar Chrome):

  • npx hyperframes lint "$COMP" — validar la composición antes del envío
  • npx hyperframes transcribe <audio> — generar subtítulos
  • npx hyperframes tts <text> — generar narración

Reserva el envío al daemon para render/inspect/preview (cualquier cosa que use Chrome).

NO llames a "$OD_NODE_BIN" "$OD_BIN" media generate --model hyperframes-html — esa ruta de despachador devuelve un 400 (AGENT_RENDERED) a propósito. HyperFrames es renderizado por ti directamente a través de npx.

NO coloques hyperframes.json / meta.json / index.html en la raíz del proyecto; el listado de archivos de OD escanea recursivamente y el usuario vería tres archivos no relacionados aparecer en el chat.

Para opciones de CLI más allá de render (lint, preview, transcribe, tts, inspect, benchmark), llámalos directamente desde tu herramienta de shell cuando la tarea lo requiera (por ejemplo, generar audio TTS en el caché antes de referenciarlo desde la composición).

Enfoque

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 subcomposiciones vs. en línea, qué pistas llevan qué (video, audio, superposiciones, subtítulos).
  3. Tiempo — qué clips impulsan la duración, dónde caen las transiciones, cuál es el ritmo.
  4. Diseño — construye primero el estado final. Consulta "Diseño antes que animación" a continuación.
  5. Animar — luego añade movimiento usando las reglas a continuación.

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

Puerta de Identidad Visual

Verifica en este orden:

  1. ¿Existe DESIGN.md en el proyecto? → Léelo. Usa sus colores, fuentes, reglas de movimiento y restricciones de "Qué NO hacer".
  2. ¿Existe visual-style.md? → Léelo. Aplica su style_prompt_full y campos estructurados. (Nota: visual-style.md es un archivo específico del proyecto. visual-styles.md es la biblioteca de estilos con 8 preajustes con nombre — archivos diferentes).
  3. ¿El usuario nombró un estilo (por ejemplo, "Swiss Pulse", "oscuro y técnico", "marca de lujo")? → Lee visual-styles.md para los 8 preajustes con nombre. Genera un DESIGN.md mínimo con: ## Style Prompt (un párrafo), ## Colors (3-5 valores hexadecimales con roles), ## Typography (1-2 familias de fuentes), ## What NOT to Do (3-5 anti-patrones).
  4. ¿Ninguno de los anteriores? → Haz 3 preguntas antes de escribir cualquier HTML:
    • ¿Cuál es el estado de ánimo? (explosivo / cinematográfico / fluido / técnico / caótico / cálido)
    • ¿Lienzo claro u oscuro?
    • ¿Algún color de marca, fuente o referencia visual específica? Luego genera un DESIGN.md mínimo a partir de las respuestas.

Cada composición debe rastrear su paleta y tipografía hasta un DESIGN.md, visual-style.md o una dirección explícita del usuario. Si estás usando #333, #3b82f6 o Roboto — te saltaste este paso.

Para valores predeterminados de movimiento, tamaño, patrones de entrada y easing, sigue house-style.md. El estilo de la casa maneja CÓMO se mueven las cosas. El DESIGN.md maneja QUÉ aspecto tienen.

Diseño antes que animación

Posiciona cada elemento donde debería estar en su momento más visible — el fotograma donde ha entrado completamente, está colocado correctamente y aún no está saliendo. Escribe esto primero como HTML+CSS estáticos. Sin GSAP todavía.

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

El proceso

  1. Identifica el fotograma heroico para cada escena — el momento en que la mayoría de los elementos son visibles simultáneamente. Este es el diseño 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; el tween describe el viaje para llegar allí.
  4. Agrega salidas con gsap.to() — anima HASTA fuera de pantalla/invisible DESDE la posición CSS.

Ejemplo

/* scene-content llena la escena, el 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 se ajusta a 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 lo largo 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 heroicos. El orden de la línea de tiempo garantiza que nunca coexistan visualmente, pero si te saltas el paso de diseño, no detectarás el caso en que se superpongan 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 diseño se trata de detectar superposiciones no intencionales — dos titulares cayendo uno sobre otro, una estadística cubriendo una etiqueta, contenido que se desborda del fotograma.

Atributos de datos

Todos los clips

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

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

Clips de composición

AtributoObligatorioValores
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 GSAP
data-width / data-heightSíDimensiones en píxeles (1920x1080 o 1080x1920)
data-composition-srcNoRuta al archivo HTML externo

Estructura de la composición

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

Estructura de subcomposició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 con ámbito */
      }
    </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 });
      // tweens...
      window.__timelines["my-comp"] = tl;
    </script>
  </div>
</template>

Carga en la 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-width="1920" data-height="1080"> y la composición raíz debería cargar los medios a través de su propio index.html.

Individual skills in this repo

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

Aurora-AI/Mad-Lab-Aurora

Produce a print-grade single-page kami (紙 / 纸) document — warm parchment canvas, ink-blue accent, serif at one weight, no italic, no cool grays. The output reads like a professional white paper or studio one-pager, not an app UI. Multilingual by design (EN · zh-CN · ja). One self-contained HTML file, zero dependencies.

Aurora-AI/Mad-Lab-Aurora

A single-frame motion-design composition with looping CSS animations — rotating type ring, animated globe, ticking timer, parallax labels. Renders as a hero video poster you can hand straight to HyperFrames or any keyframe-based exporter. Use when the brief asks for "motion design", "animated hero", "loop", "video poster", "title card", or pairs Open Claude Design with HyperFrames for a kinetic export.

Aurora-AI/Mad-Lab-Aurora

Produce a single-file slide deck in the Atelier Zero visual language (warm-paper background, italic-serif emphasis spans, coral terminating dots, surreal collage plates) — Open Design's brand deck recipe. The deck uses **horizontal magazine-style swipe pagination** (←/→, wheel, swipe), a per-slide chrome strip with brand mark and slide counter, an ESC overview grid, a coral progress bar, and inherits the canonical stylesheet + 16-slot image library from the sister `open-design-landing` skill.

Aurora-AI/Mad-Lab-Aurora

Produce a world-class single-page editorial landing site in the Atelier Zero visual language (Monocle / Apartamento / Études editorial collage) — the same aesthetic Open Design uses for its own marketing surface. The agent fills a typed `inputs.json` from a brand brief, optionally generates 16 collage assets via gpt-image-2, then runs a pure-function composer that emits a self-contained HTML file; a separate path can mirror the Astro marketing site in `apps/landing-page/`. Drop-in scroll-reveal motion and a Headroom-style sticky nav are wired automatically.

Aurora-AI/Mad-Lab-Aurora

Single-page SaaS landing with hero, features, social proof, pricing, and CTA. Respects the active DESIGN.md color/typography/layout tokens. Trigger keywords: "saas landing", "marketing page", "product landing".

Aurora-AI/Mad-Lab-Aurora

A pixel / sprite-style animated explainer slide — full-bleed cream stage, bold display year, animated pixel-art mascot (e.g. Hanafuda card, mushroom, or 8-bit console), kinetic Japanese display type, ticking timeline ribbon. Reads like a single frame of an educational motion video — looping CSS keyframes, no JS, ready to be screen-recorded into a vertical video. Use when the brief asks for a "sprite animation", "pixel-art video", "8-bit explainer", "history of X explainer", "kinetic typography history", "Nintendo-style", "精灵图动画", "像素动画", or "复古动画".

Aurora-AI/Mad-Lab-Aurora

Short-form video generation skill — 3-10 second clips for product reveals, motion teasers, ambient loops. Defaults to Seedance 2 but works the same with Kling 3 / 4, Veo 3 or Sora 2. Output is one MP4 saved to the project folder. When the workspace also ships an interactive-video / hyperframes skill, prefer composing several short shots into a single timeline rather than one long monolithic clip.

Skills relacionados