media-use: 오디오/이미지를 소싱하기 전에
/media-use를 호출하여 HeyGen 카탈로그에서 BGM/SFX/이미지를 확인하세요. 기존 에셋을 등록하려면 먼저--adopt를 실행하세요./media-use스킬을 참조하세요.
general-video — 일반 비디오 워크플로우
루트를 결정한 후에 빌드하세요. 이는 폴백(fallback) 워크플로우로, 커스텀 작품 제작을 위한 것입니다. 입력이 특화된 워크플로우에 명확히 부합하는 경우 해당 워크플로우를 우선 사용하세요: 마케팅 상품 →
/product-launch-video; 일반 사이트 →/website-to-video; 주제 설명 →/faceless-explainer; GitHub PR →/pr-to-video; 기존 푸티지 →/embedded-captions·/talking-head-recut; 짧은 내레이션 없는 모션 그래픽 →/motion-graphics; Remotion 포트 →/remotion-to-hyperframes. 범위 외: 실시간/렌더링 시 데이터, 완성된 비디오의 NLE 스타일 편집, 또는 HyperFrames가 캡처할 수 없는 푸티지 제작. 확실하지 않은 경우? 먼저/hyperframes를 읽으세요.
요청된 대로 정확히 빌드하세요. 타이틀 카드는 타이틀 카드입니다 — 타이틀 카드 + 지원 씬 세 개 + 배경 음악 + 캡션이 아닙니다. 추가 씬이나 요소가 작품을 진정으로 향상시킬 경우 _제안_하세요. 조용히 추가하지 마세요. 작은 수정(색상 수정, 한 기간 조정, 한 요소 추가)의 경우 계획 단계를 건너뛰고 바로 빌드하세요.
접근법
발견 — 개방형 요청 전용
모호하고 탐색적인 요청(예: "브랜드를 위한 무언가 만들어 줘", "멋진 인트로")의 경우 — 색상을 선택하기 전에 의도를 이해하세요:
- 대상 — 누가 시청하나요? 개발자 / 임원 / 일반 소비자?
- 플랫폼 — 어디서 재생되나요? 소셜 미디어(15초) / 웹사이트 히어로 / 제품 데모 / 내부용?
- 우선순위 — 무엇이 가장 중요한가요? 모션 품질 / 콘텐츠 정확성 / 브랜드 충실도 / 속도?
- 변형 — 하나의 최적 결과물, 또는 의미 있게 다른 2-3개의 옵션(색상 변경만이 아닌, 다른 페이싱, 에너지 또는 구조)?
구체적인 요청(예: "타이틀 카드 추가", "씬 3의 타이밍 수정")의 경우 발견 단계를 건너뛰세요.
단계 1 — 디자인 시스템 → hyperframes-creative
먼저 시각적 아이덴티티를 설정하세요. 프로젝트에 디자인 스펙이 있다면 읽으세요(우선순위 frame.md → design.md → DESIGN.md; 브랜드 진실로 취급 — 정확한 색상, 폰트, 제약 조건).
스펙이 없는 경우, 색상이나 폰트를 선택하기 전에 hyperframes-creative/references/house-style.md와 hyperframes-creative/references/video-composition.md를 모두 읽어야 합니다. house-style.md는 "프롬프트 해석 / 실제 콘텐츠 생성" 시작, 기본값 목록 및 레이어 레시피를 제공하고, video-composition.md는 "제작된" 것과 "생성된" 것을 구분하는 비디오 매체 밀도/스케일/전경 세부 묘사(데이터 막대, 등록 표시, 고정폭 메타데이터, "사용자가 요청하지 않은 두 개를 포함한 8-10개 요소")를 제공합니다. 하나만 읽는 것은 가장 흔한 실수입니다 — video-composition.md는 에이전트가 건너뛰는 파일이며, 평평하고 중앙에 배치된 웹 페이지 같은 출력을 방지하는 바로 그 파일입니다. 스스로 팔레트를 발명하고 이것들을 건너뛰지 마세요. hyperframes-creative로의 진입은 여기서 선택적 분기가 아닌 필수입니다. 그런 다음 필요에 따라 명명된 스타일/무드 → references/visual-styles.md 또는 대화형 피커 → references/design-picker.md도 참조하세요. 스펙/스타일은 브랜드를 정의하고, 구성 규칙은 정의하지 않습니다.
각도 찾기(모호한 브리프, 스펙 없음): 색상을 선택하기 전에 한 문장을 작성하세요 — 이 이름/단어/주제는 무엇을 연상시키며, 어떤 시각적 세계(은유, 설정, 악기, 모티프)가 이를 표현하나요? 예: 사이버 보안 도구 → 금고 문 / 경계 스캔 라인 / 자물쇠 텀블러; 명상 앱 → 조수, 호흡, 느린 빛 확산. 대상의 _의미_를 읽고 문자 그대로의 재스타일이 아닌 구체적인 각도를 선택하세요. 이는 단일 씬 작품에서 확장이 올바르게 생략되는 경우 프롬프트 확장(단계 2)을 대체하는 저렴한 대안이며 — 그라데이션 위의 일반 로고와 디자인된 컨셉을 구분하는 요소입니다.
<하드-게이트> HTML 작성을 시작하기 전에 다음 네 가지를 모두 확인했는지 검증하세요:
- 시각적 아이덴티티 — 스펙 또는
house-style.md에 근거하며, 즉석에서 발명된 것이 아닙니다. (#333,#3b82f6또는Roboto에 도달하고 있나요? 건너뛴 것입니다.) - 한 문장 컨셉 각도 ("각도 찾기" 단계) — 사소한 편집 이상의 모든 것에 대해, 프롬프트 단어의 문자 그대로의 재스타일이 아닙니다.
- 임베드 목록의 폰트 페어링 (
hyperframes-creative/references/typography.md→ "임베드되는 폰트") — 의도적으로 선택되었으며, 기본값으로Inter/Helvetica Neue/system-ui가 아니고, 임베드되지 않은 디스플레이 폰트가 렌더링되길 바라는 경우도 아닙니다(번들되지 않은 이름은 로컬에서 자동 캡처될 때만 임베드되며, 클라우드 렌더는 캡처하지 않습니다). video-composition.md의 전경/밀도 계획 — 가장자리 고정, 8-10개 요소, 전경 메타데이터, 배경 텍스처 규칙. (평평한 색상 위에 중앙 스택, ~6개 미만 요소, 가장자리 고정 세부 정보 없음? 건너뛴 것입니다 — 그것이 일반적인 신호입니다.) </하드-게이트>
단계 2 — 프롬프트 확장 → hyperframes-creative
모든 멀티 씬 구성에 대해 실행합니다(단일 씬 작품 및 사소한 편집은 건너뜁니다). 디자인 스펙 + 하우스 스타일에 대해 요청을 일관된 중간 표현으로 접지시켜 다운스트림 작업이 동일하게 읽히도록 합니다. hyperframes-creative/references/prompt-expansion.md를 참조하세요.
단계 3 — 계획
HTML을 작성하기 전에 높은 수준에서 생각하세요:
- 무엇 — 시청자 경험: 내러티브 아크, 핵심 순간, 감정적 비트.
- 구조 — 구성 수, 서브-컴프 vs 인라인, 어떤 트랙이 비디오/오디오/오버레이/캡션을 전달하는지. 모놀리식 단일 파일 vs 모듈식 서브-컴프 호출에 대해서는
hyperframes-core/references/composition-patterns.md§ 두 가지 아키텍처를 참조하세요(경험 법칙: ≥3개의 하드 씬 컷, 또는 재사용된 씬 → 모듈화; 짧은 단일 씬 작품은 하나의 파일 유지). - 리듬 — 구현하기 전에 패턴 이름을 지정하세요(예:
fast-fast-SLOW-SHADER-hold);hyperframes-creative/references/beat-direction.md참조. - 타이밍 — 어떤 클립이 지속 시간을 결정하는지, 트랜지션이 어디에 위치하는지, 페이싱.
- 레이아웃 — 먼저 최종 상태를 구축하세요(아래 참조).
- 애니메이션 — 그런 다음
hyperframes-animation을 통해 모션을 추가하세요.
애니메이션 전 레이아웃
각 요소를 가장 눈에 띄는 순간에 위치시킵니다 — 완전히 진입하고, 올바르게 배치되며, 아직 종료되지 않은 상태. 먼저 정적 HTML + CSS로 작성하세요. 아직 GSAP 없음.
이유: 요소를 애니메이션 시작 상태(화면 밖, 0으로 축소, 불투명도 0)에 배치하고 도달할 것이라고 생각하는 위치로 트윈하면 최종 레이아웃을 추측하는 것이며, 오버랩은 렌더링될 때까지 보이지 않습니다. 먼저 최종 상태를 구축하면 모션을 추가하기 전에 레이아웃 문제를 보고 수정할 수 있습니다.
- 각 씬의 히어로 프레임 식별 — 가장 많은 요소가 동시에 보이는 순간. 그것이 당신이 구축할 레이아웃입니다.
- 해당 프레임에 대한 정적 CSS 작성. 콘텐츠 컨테이너는 절대 오프셋이 아닌 패딩으로 씬을 채워야 합니다:
.scene-content {
display: flex;
flex-direction: column;
justify-content: center;
width: 100%;
height: 100%;
padding: 120px 160px; /* 패딩이 콘텐츠를 배치합니다. 모든 씬 크기를 채웁니다 */
gap: 24px;
box-sizing: border-box;
}
콘텐츠 컨테이너에 position: absolute; top: Npx를 절대 사용하지 마세요 — 콘텐츠가 공간보다 더 길면 오버플로됩니다. 절대 위치 지정은 장식용으로만 예약하세요.
⚠ 위의
width/height: 100%는 모든 상위 요소가 결정된 높이를 가질 때만 해결됩니다. 루트<div data-composition-id>와 그와.scene-content사이의 모든 래퍼는 크기가 지정되어야 합니다(루트에position: relative; width: 1920px; height: 1080px—hyperframes-core→ "루트 크기 지정 필요" 참조). 이를 건너뛰면 플렉스 컨테이너가 ~0으로 축소되고, 콘텐츠가 왼쪽 상단 모서리에 쌓이며, 첫 글리프가 x=0에서 잘립니다 — 반면lint/inspect는 여전히 0개의 문제를 보고합니다. 그리고 항상.scene-content에padding(≥80px)을 유지하세요: 이것은 타이틀 안전 마진입니다. 절대gap으로 대체하지 마세요.
- 진입 추가 — 화면 밖/보이지 않음에서 CSS 위치로
gsap.from()을 사용하여 애니메이션합니다(서브-컴포지션에서는gsap.fromTo()를 선호하여 시작 상태가 명시적이도록 합니다.hyperframes-core/references/sub-compositions.md참조). CSS 위치는 기본 진실입니다. 트윈은 그 위치로의 여정입니다. - 종료는 트랜지션에서 처리 —
hyperframes-animation/transitions/의 씬 트랜지션 규칙에 따라 마지막 씬만 요소를 종료 애니메이션합니다. 씬 사이에서 트랜지션이 종료 역할을 합니다.
시간에 따른 공간 공유: 같은 영역에서 요소 A가 요소 B가 진입하기 전에 종료된다면, 둘 다 각자의 히어로 프레임에 대해 올바른 CSS 위치가 필요합니다 — 타임라인 순서가 공존을 방지하고, 레이아웃 단계가 우발적인 오버랩을 잡아냅니다. 레이어된 글로우/섀도우 및 z-스택 깊이는 의도적인 오버랩입니다. 이 단계는 의도하지 않은 충돌(두 헤드라인이 서로 위에 있거나, 콘텐츠가 프레임 밖으로 흘러나감)을 잡기 위한 것입니다.
빌드 — 도메인 스킬에 위임
이것은 스킬의 전체 표면(설명 참조)을 참조에 매핑합니다 — 완전하지 않음; 의도가 나열되지 않은 경우 hyperframes-creative(모양/컨셉), hyperframes-animation(모션), hyperframes-core(계약), hyperframes-media(오디오/캡션)을 통해 라우팅하세요. 첫 번째 행은 추가적입니다 — 의도 행과 함께 읽으세요. 둘 중 하나만 읽지 마십시오.
| 빌드 중… | 먼저 읽기(순서대로) |
|---|---|
| 항상 — 모든 비-사소한 작품, 아래 의도 행에 추가로 | hyperframes-creative/references/house-style.md + references/video-composition.md (또한 단계 1 / 하드-게이트에서 게이트됨; "제작된, 생성되지 않은" 전경 세부 묘사) |
| 운동 타이포그래피 / 텍스트 중심 | hyperframes-animation/techniques.md (운동 유형) + adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md |
| 타이틀 카드 / 하단 1/3 / 오버레이 / PiP / 피사체 뒤 텍스트 | hyperframes-creative/references/composition-patterns.md + (중앙/크기 조정 프레임의 경우) hyperframes-core → "루트 크기 지정 필요" |
| 로고 / 브랜드 마크 공개 | hyperframes-animation/rules/svg-path-draw.md (그리기 켜기) + rules/3d-text-depth-layers.md + rules/scale-swap-transition.md |
| 데이터 / 통계 / 숫자 | hyperframes-animation/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-creative/references/data-in-motion.md |
| 제품 / 앱 / UI 데모 | hyperframes-animation/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md |
| 오디오 반응형 / 음악 중심 | hyperframes-creative/references/audio-reactive.md (사전 밴드 추출; 모션에 매핑) |
| 내레이션 / 음성 해설 / 음악 / SFX / 캡션 | hyperframes-media → 공유 오디오 엔진 scripts/audio.mjs (한 번 호출 = TTS + BGM + SFX → audio_meta.json); hyperframes-core를 통한 캡션 작성 + 에셋 배치. 아래 오디오 참조. |
| 멀티 씬 / 트랜지션 | hyperframes-animation/transitions/overview.md 그다음 transitions/catalog.md (개요 후에 끝난 것이 아닙니다 — GSAP 레시피는 카탈로그에 있습니다) |
| 모듈식 / 서브-컴포지션 | hyperframes-core/references/composition-patterns.md + references/sub-compositions.md |
오디오: 하나의 엔진 (TTS · BGM · SFX)
작품에 필요한 경우에만 사용하세요("요청된 대로 정확히 빌드" 규칙에 따라 — 타이틀 카드에 배경 음악 금지). TTS를 수동으로 만들거나 복사하지 마세요: 중립적인 audio_request.json을 작성하고 hyperframes-media의 공유 엔진을 호출하세요. 하나의 스위치에서 자동으로 처리 방식을 결정합니다 — HeyGen 자격 증명이 있는 경우 → HeyGen TTS + 음악/SFX 검색; 없는 경우 → ElevenLabs/Kokoro TTS, Lyria/MusicGen BGM 생성 및 번들 SFX 라이브러리 사용. 전체 플래그 목록 + 요청/메타 스키마: hyperframes-media/scripts/audio.mjs의 헤더 주석을 참조하세요.
// audio_request.json — 내레이션 세그먼트당 한 줄; `id`는 사용자 지정(`audio_meta`를 다시 조인)
{
"lines": [
{ "id": "s1", "text": "당신의 오프닝 라인.", "sfx": ["whoosh"] },
{ "id": "s2", "text": "다음 비트." },
],
"bgm": { "query": "calm cinematic underscore" }, // "mode" 생략 → 자동(HeyGen이면 검색, 아니면 생성); 비활성화하려면 "none"
}
# <MEDIA_DIR> = 설치된 hyperframes-media 스킬 디렉토리(이 스킬의 형제)
node <MEDIA_DIR>/scripts/audio.mjs --request ./audio_request.json --hyperframes . --out ./audio_meta.json
그런 다음 audio_meta.json을 읽으세요: 각 voices[].path + (bgm.path, sfx[])를 <audio> 트랙으로 마운트하고 voices[].words를 캡션에 사용하세요. 모든 작업은 hyperframes-core(오디오 트랙 + 캡션 작성)에 따릅니다. BGM이 생성 경로를 취한 경우(bgm_pending: true), 최종 렌더링 전에 hyperframes-media/scripts/wait-bgm.mjs를 실행하세요.