Communitygithub.com

Aurora-AI/Mad-Lab-Aurora

Crie composições de vídeo, animações, cartões de título, sobreposições, legendas, narrações, visuais com reatividade a áudio e transições de cena em HyperFrames HTML.

O que é Mad-Lab-Aurora?

A habilidade Aurora-AI/Mad-Lab-Aurora permite que agentes de IA criem composições de vídeo completas usando HTML como fonte da verdade, com suporte para animações GSAP, legendas sincronizadas com áudio, narração por texto-para-fala (TTS), visuais reativos a áudio (como batida sincronizada, brilho e pulsação), destaque animado de texto (varreduras de marcador, círculos desenhados à mão, linhas de explosão, rabiscos) e transições entre cenas (crossfades, cortinas, revelações). É útil para desenvolvedores e criadores que desejam automatizar a produção de vídeos diretamente de ferramentas de IA, com suporte para plataformas como Open Design (OD) e HyperFrames CLI. No ambiente OD, segue um fluxo otimizado: usa um scaffold pré-existente para edições rápidas, armazena arquivos-fonte em um cache oculto e despacha a renderização via daemon para evitar problemas de sandbox. Fora do OD, pode ser usado de forma independente com comandos como `npx hyperframes init`, `lint`, `preview`, `render`, `transcribe` e `tts`. A habilidade prioriza eficiência: apenas quando o template inicial não atende às necessidades (como múltiplas composições ou sobreposições complexas) é que se escreve o HTML do zero, economizando tempo e tokens.

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

Perguntar na sua IA favorita

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

Documentação

HyperFrames

HTML é a fonte da verdade para vídeo. Uma composição é um arquivo HTML com atributos data-* para temporização, uma timeline GSAP para animação e CSS para aparência. O framework gerencia a visibilidade dos clipes, reprodução de mídia e sincronização da timeline.

Integração com Open Design (estrutural para esta superfície)

Quando esta skill é executada dentro do Open Design (ou seja, $OD_PROJECT_DIR está definido), o fluxo de saída é fixo: apenas o .mp4 renderizado deve ser colocado na raiz do projeto. Os arquivos fonte da composição (hyperframes.json, meta.json, index.html, assets) pertencem a um diretório de cache oculto para não poluir o FileViewer do usuário ou os chips de "arquivos produzidos" do chat.

Fluxo de renderização dentro do OD — caminho rápido:

Para a maioria das solicitações OD ("vídeo de teste", "revelação de produto de 5s", "clipe de demonstração"), NÃO escreva o HTML da composição do zero. Use o scaffold embutido do HyperFrames e edite apenas o que o prompt realmente muda. O caminho "criar do zero" custa minutos de saída do modelo e tempo de ferramenta de chat silencioso; o caminho do scaffold custa segundos.

# 1. Escolha um slot de cache oculto. Prefixo com ponto → a listagem de arquivos do projeto OD
#    o ignora, então os arquivos fonte nunca poluem o chat.
COMP_REL=".hyperframes-cache/$(date +%s)-$(openssl rand -hex 2)"
COMP="$OD_PROJECT_DIR/$COMP_REL"

# 2. Obtenha um scaffold imediatamente renderizável (hyperframes.json,
#    meta.json, index.html com GSAP CDN + window.__timelines.main
#    já registrados). Isso é executado no seu shell — cópia de arquivo pura,
#    sem Chrome, sem rede além do cache npx.
npx hyperframes init "$COMP" --example blank --skip-skills --non-interactive

# 3. Edite APENAS $COMP/index.html — altere `data-duration` na raiz
#    se precisar de um comprimento não padrão, troque a paleta de espaço reservado
#    em <style>, adicione 1–3 <div>s de clipe para texto/imagens e anexe
#    os tweens GSAP correspondentes dentro do bloco existente
#    `window.__timelines["main"] = gsap.timeline({paused:true})`.
#    Mantenha as edições mínimas; o scaffold já é HF válido.

# 4. Envie a renderização através do daemon OD. NÃO execute `npx hyperframes
#    render` a partir deste shell — o daemon executa para você em um
#    processo sem sandbox. (Muitos CLIs de agente, Claude Code em particular,
#    envolvem Bash em sandbox-exec do macOS, sob o qual o subprocesso Chrome do puppeteer
#    trava parcialmente durante a captura de frames. O processo do daemon
#    não tem sandbox, então as renderizações são concluídas de forma confiável.)
#
#    O despachante retorna em ~1s com um {taskId}; conduza a
#    renderização até a conclusão fazendo um loop de chamadas `"$OD_NODE_BIN" "$OD_BIN" media wait <taskId>`.
#    Cada chamada faz long-poll de até 25s (muito abaixo do limite padrão de 30s
#    da sua ferramenta de shell) e sai com 0/2/5 para sinalizar concluído/em execução/falha.
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 chamada generate e cada chamada wait duram no máximo ~25s, então o limite padrão de ~30s da ferramenta de shell do agente nunca é acionado. As linhas de progresso do HF (Capturing frame N/M) são transmitidas para stderr ao vivo durante todo o loop. Quando a renderização termina, a última linha de stdout é {"file": { "name": "<output>", "size": …, "kind": "video", … }} — cite file.name em sua resposta para que o usuário saiba o que foi produzido.

Pule o Portão de Identidade Visual dentro do OD. A seção HARD-GATE abaixo (sob "Abordagem") diz para você ler DESIGN.md / visual-style.md ou parar e fazer 3 perguntas de humor antes de escrever qualquer composição. Esse portão é para projetos HF independentes. Projetos OD já têm sua própria camada de sistema de design — o usuário escolheu sua direção visual na criação do projeto. Para uma renderização de teste OD, use como padrão: canvas escuro (#0b0b0f), um acento quente (#ffb76b), um acento frio (#7da4ff), movimento contido. Só peça contribuição estilística se o prompt do usuário for muito vago para escolher um assunto (muito raro).

Quando pular o scaffold e escrever do zero: apenas quando o usuário pedir explicitamente algo que o modelo em branco claramente não pode hospedar (por exemplo, timelines de múltiplas composições, overlays reativos a áudio, legendas sincronizadas com uma faixa TTS que eles já geraram). Para todo o resto, init + edit é o caminho padrão.

Os subcomandos HF mais leves que você AINDA pode executar do seu próprio shell (eles não precisam iniciar o Chrome):

  • npx hyperframes lint "$COMP" — valida composição antes do envio
  • npx hyperframes transcribe <audio> — gera legendas
  • npx hyperframes tts <text> — gera narração

Reserve o despacho do daemon para render/inspect/preview (qualquer coisa vinculada ao Chrome).

NÃO chame "$OD_NODE_BIN" "$OD_BIN" media generate --model hyperframes-html — esse caminho de despachante retorna um 400 (AGENT_RENDERED) de propósito. O HyperFrames é renderizado por você diretamente via npx.

NÃO coloque hyperframes.json / meta.json / index.html na raiz do projeto; a listagem de arquivos do OD varre recursivamente e o usuário veria três arquivos não relacionados aparecerem no chat.

Para opções de CLI além de render (lint, preview, transcribe, tts, inspect, benchmark), chame-as diretamente da sua ferramenta de shell quando a tarefa justificar (por exemplo, gerar áudio TTS no cache antes de referenciá-lo na composição).

Abordagem

Antes de escrever HTML, pense em alto nível:

  1. O quê — o que o espectador deve experimentar? Identifique o arco narrativo, os momentos-chave e os batimentos emocionais.
  2. Estrutura — quantas composições, quais são sub-composições vs inline, quais trilhas carregam o quê (vídeo, áudio, overlays, legendas).
  3. Temporização — quais clipes conduzem a duração, onde as transições ocorrem, qual é o ritmo.
  4. Layout — construa o estado final primeiro. Veja "Layout Antes da Animação" abaixo.
  5. Animar — então adicione movimento usando as regras abaixo.

Para pequenas edições (corrigir uma cor, ajustar temporização, adicionar um elemento), vá direto para as regras.

Portão de Identidade Visual

Verifique nesta ordem:

  1. DESIGN.md existe no projeto? → Leia. Use suas cores exatas, fontes, regras de movimento e restrições "O que NÃO Fazer".
  2. visual-style.md existe? → Leia. Aplique seu style_prompt_full e campos estruturados. (Nota: visual-style.md é um arquivo específico do projeto. visual-styles.md é a biblioteca de estilos com 8 predefinições nomeadas — arquivos diferentes.)
  3. Usuário nomeou um estilo (por exemplo, "Swiss Pulse", "dark and techy", "luxury brand")? → Leia visual-styles.md para as 8 predefinições nomeadas. Gere um DESIGN.md mínimo com: ## Style Prompt (um parágrafo), ## Colors (3-5 valores hex com funções), ## Typography (1-2 famílias de fonte), ## What NOT to Do (3-5 anti-padrões).
  4. Nenhum dos acima? → Faça 3 perguntas antes de escrever qualquer HTML:
    • Qual é o clima? (explosivo / cinematográfico / fluido / técnico / caótico / quente)
    • Canvas claro ou escuro?
    • Alguma cor de marca, fonte ou referência visual específica? Então gere um DESIGN.md mínimo a partir das respostas.

Cada composição deve rastrear sua paleta e tipografia de volta a um DESIGN.md, visual-style.md ou direção explícita do usuário. Se você está recorrendo a #333, #3b82f6 ou Roboto — você pulou esta etapa.

Para padrões de movimento, dimensionamento, padrões de entrada e easing — siga house-style.md. O estilo da casa lida com COMO as coisas se movem. O DESIGN.md lida com a APARÊNCIA das coisas.

Layout Antes da Animação

Posicione cada elemento onde ele deve estar em seu momento mais visível — o frame onde ele entrou completamente, está colocado corretamente e ainda não está saindo. Escreva isso como HTML+CSS estático primeiro. Ainda sem GSAP.

Por que isso é importante: Se você posicionar elementos em seu estado inicial animado (fora da tela, dimensionados para 0, opacidade 0) e aplicar tween para onde você acha que eles devem pousar, você está adivinhando o layout final. Sobreposições são invisíveis até o vídeo ser renderizado. Ao construir o estado final primeiro, você pode ver e corrigir problemas de layout antes de adicionar qualquer movimento.

O processo

  1. Identifique o frame heroico para cada cena — o momento em que o maior número de elementos está simultaneamente visível. Este é o layout que você constrói.
  2. Escreva CSS estático para esse frame. O contêiner .scene-content DEVE preencher a cena inteira usando width: 100%; height: 100%; padding: Npx; com display: flex; flex-direction: column; gap: Npx; box-sizing: border-box. Use padding para empurrar o conteúdo para dentro — NUNCA position: absolute; top: Npx em um contêiner de conteúdo. Contêineres de conteúdo com posicionamento absoluto transbordam quando o conteúdo é mais alto que o espaço restante. Reserve position: absolute apenas para elementos decorativos.
  3. Adicione entradas com gsap.from() — anime DE fora da tela/invisível PARA a posição CSS. A posição CSS é a verdade absoluta; o tween descreve a jornada para chegar lá.
  4. Adicione saídas com gsap.to() — anime PARA fora da tela/invisível A PARTIR da posição CSS.

Exemplo

/* scene-content preenche a cena, padding posiciona o conteúdo */
.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;
}
/* O contêiner preenche qualquer tamanho de cena (1920x1080, 1080x1920, etc).
   Padding posiciona o conteúdo. Flex + gap lida com o espaçamento. */

ERRADO — dimensões codificadas e posicionamento absoluto:

.scene-content {
  position: absolute;
  top: 200px;
  left: 160px;
  width: 1920px;
  height: 1080px;
  display: flex; /* ... */
}
// Etapa 3: Anime PARA essas posições
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);

// Etapa 4: Anime PARA FORA dessas posições
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);

Quando elementos compartilham espaço ao longo do tempo

Se o elemento A sai antes do elemento B entrar na mesma área, ambos devem ter posições CSS corretas para seus respectivos frames heroicos. A ordenação da timeline garante que eles nunca coexistam visualmente — mas se você pular a etapa de layout, não perceberá o caso em que eles se sobrepõem acidentalmente devido a um erro de temporização.

O que conta como sobreposição intencional

Efeitos em camadas (brilho atrás do texto, elementos de sombra, padrões de fundo) e designs empilhados em z (pilhas de cartas, camadas de profundidade) são intencionais. A etapa de layout é sobre capturar sobreposições não intencionais — dois títulos pousando um em cima do outro, uma estatística cobrindo um rótulo, conteúdo vazando para fora do frame.

Atributos de Dados

Todos os Clipes

AtributoObrigatórioValores
idSimIdentificador único
data-startSimSegundos ou referência de ID do clipe ("el-1", "intro + 2")
data-durationObrigatório para img/div/composiçõesSegundos. Vídeo/áudio padrão é a duração da mídia.
data-track-indexSimInteiro. Clipes na mesma trilha não podem se sobrepor.
data-media-startNãoDeslocamento de corte na fonte (segundos)
data-volumeNão0-1 (padrão 1)

data-track-index não afeta a camada visual — use CSS z-index.

Clipes de Composição

AtributoObrigatórioValores
data-composition-idSimID único da composição
data-startSimTempo de início (composição raiz: use "0")
data-durationSimTem precedência sobre a duração da timeline GSAP
data-width / data-heightSimDimensões em pixels (1920x1080 ou 1080x1920)
data-composition-srcNãoCaminho para arquivo HTML externo

Estrutura da Composição

Sub-composições carregadas via data-composition-src usam um wrapper <template>. Composições independentes (o index.html principal) NÃO usam <template> — elas colocam a div data-composition-id diretamente em <body>. Usar <template> em um arquivo independente esconde todo o conteúdo do navegador e quebra a renderização.

Estrutura da sub-composição:

<template id="my-comp-template">
  <div data-composition-id="my-comp" data-width="1920" data-height="1080">
    <!-- conteúdo -->
    <style>
      [data-composition-id="my-comp"] {
        /* estilos com escopo */
      }
    </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>

Carregar na raiz: <div id="el-1" data-composition-id="my-comp" data-composition-src="compositions/my-comp.html" data-star ...>

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.

Habilidades Relacionadas