Communitygithub.com

Aurora-AI/Mad-Lab-Aurora

HyperFrames HTML을 사용해 비디오 컴포지션, 애니메이션, 타이틀 카드, 오버레이, 캡션, 음성 해설, 오디오 반응형 비주얼 및 장면 전환을 생성합니다. HTML 기반 비디오 콘텐츠 제작, 오디오와 동기화된 캡션/자막 추가, 텍스트 음성 변환 내레이션 생성, 오디오 반응형 애니메이션(비트 싱크, 글로우, 펄스), 애니메이션 텍스트 하이라이트(마커 스윕, 손으로 그린 원, 버스트 라인, 스크리블, 스케치아웃) 또는 장면 간 전환(크로스페이드, 와이프, 리빌, 셰이더 전환)을 구현해야 할 때 사용합니다. 컴포지션 제작, 타이밍, 미디어 및 전체 비디오 제작 워크플로우를 다룹니다. CLI 명령어(init, lint, preview, render, transcribe, tts)는 hyperframes-cli 스킬을 참고하세요.

Mad-Lab-Aurora란 무엇인가요?

Aurora-AI/Mad-Lab-Aurora는 HyperFrames 프레임워크를 기반으로 HTML을 비디오 제작의 진실 공급원(source of truth)으로 활용하는 AI 에이전트 스킬입니다. 이 스킬은 Claude Code, Cursor, Codex와 같은 AI 코딩 에이전트가 HTML, GSAP 타임라인 및 CSS를 사용하여 전문적인 비디오 컴포지션을 작성할 수 있도록 설계되었습니다. 특히 Open Design(OD) 환경에 최적화되어 있어, 숨겨진 캐시 디렉토리를 통해 컴포지션 소스 파일을 관리하고, OD 데몬을 통해 안정적인 렌더링을 지원합니다. 주요 기능으로는 비디오 컴포지션 생성, 애니메이션, 타이틀 카드, 오버레이, 캡션, 음성 해설, 오디오 반응형 비주얼, 장면 전환을 포함하며, CLI 명령어(npx hyperframes init/lint/render 등)를 통해 다양한 작업을 수행할 수 있습니다. 또한 시각적 아이덴티티 게이트(Visual Identity Gate) 시스템을 통해 모든 컴포지션에 일관된 디자인 시스템을 적용하도록 강제하며, '레이아웃 우선, 애니메이션 나중' 접근법으로 충돌 없는 비디오 구성을 보장합니다.

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

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

HyperFrames

HTML은 비디오의 진실 공급원입니다. 컴포지션은 data-* 속성으로 타이밍을 지정하고, GSAP 타임라인으로 애니메이션을 적용하며, CSS로 모양을 정의하는 HTML 파일입니다. 프레임워크는 클립 가시성, 미디어 재생 및 타임라인 동기화를 처리합니다.

Open Design 통합 (이 표면에 중요한 사항)

이 스킬이 Open Design 내에서 실행될 때(즉, $OD_PROJECT_DIR이 설정된 경우), 출력 흐름은 고정됩니다: 렌더링된 .mp4 파일만 프로젝트 루트에 배치되어야 합니다. 컴포지션 소스 파일(hyperframes.json, meta.json, index.html, 에셋)은 숨겨진 캐시 디렉토리 안에 위치하여 사용자의 FileViewer나 채팅의 "생성된 파일" 칩을 어지럽히지 않도록 해야 합니다.

OD 내 렌더링 워크플로우 — 빠른 경로:

대부분의 OD 요청("테스트 비디오", "5초 제품 리빌", "데모 클립")의 경우, 처음부터 컴포지션 HTML을 작성하지 마십시오. HyperFrames의 내장 스캐폴드를 사용하고 프롬프트가 실제로 변경하는 부분만 편집하십시오. "처음부터 작성" 경로는 수 분의 모델 출력과 무음 채팅-도구 시간을 소모하지만, 스캐폴드 경로는 몇 초밖에 걸리지 않습니다.

# 1. 숨겨진 캐시 슬롯을 선택합니다. 점 파일 접두사 → OD의 프로젝트 파일
#    목록에서 건너뛰므로 소스 파일이 채팅을 어지럽히지 않습니다.
COMP_REL=".hyperframes-cache/$(date +%s)-$(openssl rand -hex 2)"
COMP="$OD_PROJECT_DIR/$COMP_REL"

# 2. 즉시 렌더링 가능한 스캐폴드를 가져옵니다(hyperframes.json,
#    meta.json, GSAP CDN + window.__timelines.main이
#    이미 등록된 index.html). 셸에서 실행됩니다 — 순수 파일 복사,
#    Chrome이 필요 없으며 npx 캐시 외에는 네트워크도 필요 없습니다.
npx hyperframes init "$COMP" --example blank --skip-skills --non-interactive

# 3. $COMP/index.html만 편집합니다 — 기본 길이가 아닌 경우 루트의
#    `data-duration`을 변경하고, <style> 내의 플레이스홀더 팔레트를
#    교체하고, 텍스트/이미지를 위한 1–3개의 클립 <div>를 추가하고,
#    기존 `window.__timelines["main"] = gsap.timeline({paused:true})` 블록
#    내에 일치하는 GSAP 트윈을 추가합니다. 편집을 최소한으로 유지하십시오.
#    스캐폴드는 이미 유효한 HF입니다.

# 4. OD 데몬을 통해 렌더링을 전달합니다. 이 셸에서 `npx hyperframes
#    render`를 실행하지 마십시오 — 데몬이 샌드박스 없는 프로세스에서
#    대신 실행합니다. (많은 에이전트 CLI, 특히 Claude Code는 Bash를
#    macOS sandbox-exec으로 래핑하며, 이 환경에서는 puppeteer의 Chrome
#    하위 프로세스가 프레임 캡처 중간에 중단됩니다. 데몬 프로세스는
#    샌드박스가 없으므로 렌더링이 안정적으로 완료됩니다.)
#
#    전달자는 ~1초 내에 {taskId}를 반환합니다. `"$OD_NODE_BIN" "$OD_BIN" media wait <taskId>` 호출을
#    반복하여 렌더링이 완료될 때까지 구동합니다.
#    각 호출은 최대 25초 동안 롱 폴링(셸 도구의 기본 30초 제한 미만)하며
#    완료/실행 중/실패를 나타내기 위해 0/2/5로 종료됩니다.
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"; }

각 generate 및 각 wait 호출은 최대 ~25초 동안 지속되므로 에이전트 셸 도구의 기본 ~30초 제한이 절대 트리거되지 않습니다. HF의 진행 줄(Capturing frame N/M)은 루프 전체에 걸쳐 stderr로 실시간 스트리밍됩니다. 렌더링이 완료되면 마지막 stdout 줄은 {"file": { "name": "<output>", "size": …, "kind": "video", … }}입니다. 응답에서 file.name을 인용하여 사용자에게 생성된 내용을 알리십시오.

OD 내에서 시각적 아이덴티티 게이트를 건너뛰십시오. 아래 "접근 방식"의 HARD-GATE 섹션은 컴포지션을 작성하기 전에 DESIGN.md / visual-style.md를 읽거나 중단하고 3가지 분위기 질문을 하라고 지시합니다. 해당 게이트는 독립형 HF 프로젝트를 위한 것입니다. OD 프로젝트에는 이미 자체 디자인 시스템 계층이 있습니다 — 사용자는 프로젝트 생성 시 시각적 방향을 선택했습니다. OD 테스트 렌더링의 경우 기본값은 다음과 같습니다: 어두운 캔버스(#0b0b0f), 하나의 따뜻한 악센트(#ffb76b), 하나의 차가운 악센트(#7da4ff), 절제된 모션. 사용자의 프롬프트가 주제조차 선택하기에 너무 모호한 경우에만(매우 드물게) 스타일 입력을 요청하십시오.

처음부터 스캐폴드를 건너뛰고 작성해야 하는 경우: 사용자가 빈 템플릿이 명확히 호스팅할 수 없는 것을 명시적으로 요청하는 경우에만 해당합니다(예: 다중 컴포지션 타임라인, 오디오 반응형 오버레이, 이미 생성한 TTS 트랙과 동기화된 캡션). 그 외 모든 경우에는 init + 편집이 기본 경로입니다.

셸에서 직접 실행할 수 있는 더 가벼운 HF 하위 명령어(Chrome을 스폰할 필요 없음):

  • npx hyperframes lint "$COMP" — 전달 전 컴포지션 유효성 검사
  • npx hyperframes transcribe <audio> — 캡션 생성
  • npx hyperframes tts <text> — 내레이션 생성

render/inspect/preview(Chrome이 필요한 모든 것)는 데몬 전달용으로 예약하십시오.

"$OD_NODE_BIN" "$OD_BIN" media generate --model hyperframes-html을 호출하지 마십시오 — 해당 전달자 경로는 의도적으로 400(AGENT_RENDERED)을 반환합니다. HyperFrames는 npx를 통해 사용자가 직접 렌더링합니다.

hyperframes.json / meta.json / index.html을 프로젝트 루트에 넣지 마십시오; OD의 파일 목록이 재귀적으로 스캔하므로 사용자가 채팅에 세 개의 관련 없는 파일이 나타난 것을 보게 됩니다.

render 외의 CLI 옵션(lint, preview, transcribe, tts, inspect, benchmark)의 경우, 작업이 필요할 때 셸 도구에서 직접 호출하십시오(예: 컴포지션에서 참조하기 전에 캐시에 TTS 오디오 생성).

접근 방식

HTML을 작성하기 전에 높은 수준에서 생각하십시오:

  1. 무엇 — 시청자는 무엇을 경험해야 합니까? 내러티브 아크, 주요 순간 및 감정적 비트를 식별하십시오.
  2. 구조 — 몇 개의 컴포지션, 인라인 대 하위 컴포지션, 어떤 트랙이 무엇(비디오, 오디오, 오버레이, 캡션)을 전달합니까.
  3. 타이밍 — 어떤 클립이 지속 시간을 결정하며, 전환이 어디에 배치되고, 페이싱은 어떻습니까.
  4. 레이아웃 — 먼저 최종 상태를 구축하십시오. 아래의 "애니메이션 전 레이아웃"을 참조하십시오.
  5. 애니메이션 — 그런 다음 아래 규칙을 사용하여 모션을 추가하십시오.

작은 편집의 경우(색상 수정, 타이밍 조정, 요소 하나 추가), 규칙으로 바로 건너뛰십시오.

시각적 아이덴티티 게이트

다음 순서로 확인하십시오:

  1. 프로젝트에 DESIGN.md가 있습니까? → 읽으십시오. 정확한 색상, 글꼴, 모션 규칙 및 "하지 말아야 할 것" 제약 조건을 사용하십시오.
  2. visual-style.md가 있습니까? → 읽으십시오. style_prompt_full 및 구조화된 필드를 적용하십시오. (참고: visual-style.md는 프로젝트별 파일입니다. visual-styles.md는 8개의 명명된 프리셋이 있는 스타일 라이브러리입니다 — 다른 파일입니다.)
  3. 사용자가 스타일을 명명했습니까(예: "Swiss Pulse", "어둡고 기술적인", "럭셔리 브랜드")? → 8개의 명명된 프리셋에 대해 visual-styles.md를 읽으십시오. 다음을 포함하는 최소한의 DESIGN.md를 생성하십시오: ## Style Prompt (한 문단), ## Colors (역할이 있는 3-5개의 헥스 값), ## Typography (1-2개의 글꼴 패밀리), ## What NOT to Do (3-5개의 안티 패턴).
  4. 위 중 어느 것도 해당되지 않습니까? → HTML을 작성하기 전에 3가지 질문을 하십시오:
    • 분위기는 어떻습니까? (폭발적 / 영화적 / 유동적 / 기술적 / 혼란스러운 / 따뜻한)
    • 밝은 캔버스 또는 어두운 캔버스?
    • 특정 브랜드 색상, 글꼴 또는 시각적 참조가 있습니까? 그런 다음 답변에서 최소한의 DESIGN.md를 생성하십시오.

모든 컴포지션은 팔레트와 타이포그래피를 DESIGN.md, visual-style.md 또는 명시적인 사용자 지시로 추적해야 합니다. #333, #3b82f6 또는 Roboto를 사용하고 있다면 — 이 단계를 건너뛴 것입니다.

모션 기본값, 크기 조정, 진입 패턴 및 이징의 경우 house-style.md를 따르십시오. 하우스 스타일은 요소가 HOW 움직이는지를 처리합니다. DESIGN.md는 요소가 WHAT처럼 보이는지를 처리합니다.

애니메이션 전 레이아웃

모든 요소를 가장 눈에 띄는 순간 — 완전히 진입하고, 올바르게 배치되고, 아직 종료되지 않은 프레임 — 에 배치하십시오. 먼저 정적 HTML+CSS로 작성하십시오. 아직 GSAP은 사용하지 마십시오.

이것이 중요한 이유: 요소를 애니메이션 시작 상태(화면 밖, 0으로 축소, 불투명도 0)에 배치하고 도착할 것으로 예상되는 위치로 트윈하면 최종 레이아웃을 추측하는 것입니다. 비디오가 렌더링될 때까지 겹침이 보이지 않습니다. 먼저 최종 상태를 구축하면 모션을 추가하기 전에 레이아웃 문제를 보고 수정할 수 있습니다.

프로세스

  1. 각 장면에 대해 히어로 프레임을 식별하십시오 — 가장 많은 요소가 동시에 보이는 순간입니다. 이것이 구축할 레이아웃입니다.
  2. 해당 프레임에 대해 정적 CSS를 작성하십시오. .scene-content 컨테이너는 width: 100%; height: 100%; padding: Npx;를 사용하여 display: flex; flex-direction: column; gap: Npx; box-sizing: border-box로 전체 장면을 채워야 합니다. 패딩을 사용하여 콘텐츠를 안쪽으로 밀어 넣으십시오 — 콘텐츠 컨테이너에 position: absolute; top: Npx를 절대 사용하지 마십시오. 절대 위치 콘텐츠 컨테이너는 콘텐츠가 남은 공간보다 높을 때 오버플로됩니다. position: absolute는 장식용으로만 예약하십시오.
  3. gsap.from()을 사용하여 진입을 추가하십시오 — 화면 밖/보이지 않음에서 CSS 위치로 애니메이션합니다. CSS 위치는 진실 공급원입니다. 트윈은 그곳에 도달하기 위한 여정을 설명합니다.
  4. gsap.to()를 사용하여 종료를 추가하십시오 — CSS 위치에서 화면 밖/보이지 않음으로 애니메이션합니다.

예제

/* scene-content가 장면을 채우고, 패딩이 콘텐츠를 배치합니다 */
.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;
}
/* 컨테이너는 모든 장면 크기(1920x1080, 1080x1920 등)를 채웁니다.
   패딩이 콘텐츠를 배치합니다. Flex + gap이 간격을 처리합니다. */

잘못된 예 — 하드코딩된 치수 및 절대 위치 지정:

.scene-content {
  position: absolute;
  top: 200px;
  left: 160px;
  width: 1920px;
  height: 1080px;
  display: flex; /* ... */
}
// 단계 3: 해당 위치로 애니메이션
service.from(".title", { y: 60, opacity: 0, duration: 0.6, ease: "power3.out" }, 0);
service.from(".subtitle", { y: 40, opacity: 0, duration: 0.5, ease: "power3.out" }, 0.2);
service.from(".logo", { scale: 0.8, opacity: 0, duration: 0.4, ease: "power2.out" }, 0.3);

// 단계 4: 해당 위치에서 밖으로 애니메이션
service.to(".title", { y: -40, opacity: 0, duration: 0.4, ease: "power2.in" }, 3);
service.to(".subtitle", { y: -30, opacity: 0, duration: 0.3, ease: "power2.in" }, 3.1);
service.to(".logo", { scale: 0.9, opacity: 0, duration: 0.3, ease: "power2.in" }, 3.2);

요소가 시간에 걸쳐 공간을 공유하는 경우

요소 A가 같은 영역에서 요소 B가 진입하기 전에 종료되면, 두 요소 모두 각각의 히어로 프레임에 대해 올바른 CSS 위치를 가져야 합니다. 타임라인 순서는 시각적으로 공존하지 않음을 보장합니다 — 그러나 레이아웃 단계를 건너뛰면 타이밍 오류로 인해 우발적으로 겹치는 경우를 발견하지 못합니다.

의도적인 겹침으로 간주되는 것

계층적 효과(텍스트 뒤의 글로우, 그림자 요소, 배경 패턴) 및 z-스택 디자인(카드 스택, 깊이 레이어)은 의도적입니다. 레이아웃 단계는 의도하지 않은 겹침을 잡기 위한 것입니다 — 두 개의 제목이 서로 위에 겹쳐짐, 통계가 레이블을 덮음, 콘텐츠가 프레임 밖으로 흘러나감.

데이터 속성

모든 클립

속성필수값
id예고유 식별자
data-start예초 또는 클립 ID 참조 ("el-1", "intro + 2")
data-durationimg/div/컴포지션에 필수초. 비디오/오디오는 미디어 지속 시간을 기본값으로 사용합니다.
data-track-index예정수. 같은 트랙의 클립은 겹칠 수 없습니다.
data-media-start아니오소스로의 트림 오프셋(초)
data-volume아니오0-1 (기본값 1)

data-track-index는 시각적 레이어링에 영향을 주지 않습니다 — CSS z-index를 사용하십시오.

컴포지션 클립

속성필수값
data-composition-id예고유 컴포지션 ID
data-start예시작 시간 (루트 컴포지션: "0" 사용)
data-duration예GSAP 타임라인 지속 시간보다 우선합니다
data-width / data-height예픽셀 치수 (1920x1080 또는 1080x1920)
data-composition-src아니오외부 HTML 파일 경로

컴포지션 구조

data-composition-src를 통해 로드된 하위 컴포지션은 <template> 래퍼를 사용합니다. 독립형 컴포지션(기본 index.html)은 <template>을 사용하지 않습니다 — data-composition-id div를 직접 <body>에 넣습니다. 독립형 파일에 <template>을 사용하면 모든 콘텐츠가 브라우저에서 숨겨져 렌더링이 중단됩니다.

하위 컴포지션 구조:

<template id="my-comp-template">
  <div data-composition-id="my-comp" data-width="1920" data-height="1080">
    <!-- 콘텐츠 -->
    <style>
      [data-composition-id="my-comp"] {
        /* 범위가 지정된 스타일 */
      }
    </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 });
      // 트윈...
      window.__timelines["my-comp"] = tl;
    </script>
  </div>
</template>

루트에서 로드: <div id="el-1" data-composition-id="my-comp" data-composition-src="compositions/my-comp.html" data-start="0" data-duration="5" data-track-index="0"></div>

독립형 컴포지션 구조

<!DOCTYPE html>
<html>
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <meta name="hyperframes-viewport" content="width=1920,height=1080">
  <title>내 컴포지션</title>
  <script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/gsap.min.js"></script>
  <style>
    body { margin: 0; overflow: hidden; }
    /* ... */
  </style>
</head>
<body>
  <div id="scene-root" data-composition-id="main" data-width="1920" data-height="1080" data-duration="10">
    <!-- 장면 콘텐츠 -->
  </div>
  <script>
    const tl = gsap.timeline({ paused: true });
    window.__timelines["main"] = tl;
  </script>
</body>
</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.

관련 스킬