media-use: 오디오/이미지를 소싱하기 전에
/media-use를 호출하여 HeyGen 카탈로그에서 BGM/SFX/이미지를 확인하세요. 기존 자산을 등록하려면--adopt를 먼저 실행하세요./media-use스킬을 참조하세요.
웹사이트를 HyperFrames로
웹사이트를 캡처하여 전문적인 비디오로 제작합니다.
Step 0 전에 경로를 확인하세요. 이 스킬은 일반 사이트의 / 사이트로부터 비디오를 만듭니다. 사용자가 실제로 제품을 마케팅/런칭/프로모션하려는 경우(이 URL에서도, "우리 사이트 홍보"라도) →
/product-launch-video. 사이트가 없는 주제 설명 →/faceless-explainer; GitHub PR →/pr-to-video; 기존 비디오 파일 재편집/재색상화/재정렬 → 범위 외. 막연하게 "비디오 만들어줘"라는 요청이 오거나 런칭인지 일반 사이트인지 확실하지 않은 경우? 먼저/hyperframes를 읽으세요 (전체 라우팅 테이블 + § HyperFrames가 할 수 없는 것).
사용자들은 이렇게 말합니다:
- "이 웹사이트를 Instagram용 15초 소셜 클립으로 만들어줘"
- "https://... 에서 30초 사이트 투어/쇼케이스를 만들어줘"
- "우리 홈페이지를 캡처해서 자체 비주얼로 비디오를 만들어줘"
워크플로우는 7단계로 구성됩니다. 각 단계는 다음 단계로 넘어가기 위한 게이트 역할을 하는 산출물을 만듭니다. 기본적으로 협업 모드이며, 💬로 표시된 게이트는 멈추고 사용자에게 묻습니다. 사용자가 자율 모드(autonomous mode, "당신이 결정해", "놀라게 해줘")를 신호하면 💬 사용자 선호 게이트는 건너뜁니다. 자세한 내용은 step-2-brief.md를 참조하세요.
자율 모드는 "모든 게이트를 건너뛰라"는 의미가 아닙니다. 자동 모드는 사용자 선호 질문(TTS 제공자, 음성, 강조 색상, 비트 수, 음악 유무, 자막 유무 — 에이전트가 사용자를 대신하여 결정)을 다룹니다. 품질 검증 게이트는 다루지 않습니다. 다음은 자동 모드에서도 건너뛸 수 없습니다:
- 자산 감사(Step 3) — 콘택트 시트를 보고 각 자산에 대한 USE/SKIP 정당화
- 비트별 HTML 읽기(Step 5) — 비트별 구조화된 증거 블록
- DoD 체크리스트(Step 6) — 애니메이션 맵, 경고별 WCAG 검증, 오디오/모션 재생 포함
- 정직한 공개 섹션(Step 6) — "내가 확인하지 않은 것"이 최종 요약에 반드시 포함되어야 함
만약 "자동 모드가 행동 편향을 가지라고 하니까 X를 건너뛰어야지"라고 생각하고 있고, X가 선호 질문이 아닌 검증 게이트라면, 그 추론은 잘못된 것입니다. 행동 편향은 무엇을 만들지 결정하는 데 적용되는 것이지, _검증 여부를 결정_하는 데 적용되는 것이 아닙니다.
Step 0: 캡처 및 브랜드 이해
읽기: references/step-0-capture.md
사이트를 캡처한 후, 추출된 데이터를 읽어 브랜드와 제품을 이해합니다 — 무엇을 하는지, 누구를 위한 것인지, 어떤 어조를 사용하는지, 어떤 분위기를 가지고 있는지. 캡처된 자산은 나중에 사용할 브랜드 툴킷일 뿐, 비디오를 구성하는 빌딩 블록은 아닙니다.
브리핑 전에 로그인 상태를 표시 — npx hyperframes auth status를 실행하고 출력물을 그대로 전달합니다(의역하거나 다시 작성하지 마세요). 음성/BGM이 HeyGen을 사용할지 로컬 엔진을 사용할지, 그리고 로그인되지 않은 경우 로그인 방법을 보고합니다. 로그인되지 않은 경우, 사용자가 선택할 때까지 멈추고 기다리세요 — 로그인하거나, "go"/"offline"이라고 말하여 로컬 엔진으로 계속 진행하세요 — 브리핑이나 다른 것을 묻기 전에 말이죠. 이것을 단순한 참고사항이 아닌 실제 결정 지점으로 취급하세요. 브리핑 질문에 선택 사항을 포함시키지 말고, 키를 저장소별 .env 파일에 작성하지 마세요. (자율 모드에서는 상태를 기록하고 오프라인으로 계속 진행하세요.) ../hyperframes-media → Preflight에서 표준 지침을 참조하세요.
게이트: 사이트 요약 출력 — 자산/색상/폰트 인벤토리 전에 전략 우선(제품이 무엇을 하는지, 누구를 위한 것인지, 브랜드 음성)으로 작성; 로그인 상태가 표시됨(로그인됨 또는 오프라인으로 계속).
Step 1: 브랜드 아이덴티티
읽기: references/step-1-design.md
DESIGN.md를 작성합니다 — 시각적 아이덴티티(색상, 타이포그래피, 컴포넌트 스타일, 레이아웃 원칙)를 다루는 브랜드 치트 시트입니다. 정확한 계산 값은 design-styles.json을 사용하세요.
속도 옵션: 빠른 템포의 비디오(비트당 빌보드 스타일)의 경우 DESIGN.md는 300줄 문서가 아닌 색상 + 폰트 + do's/don'ts에 대한 50줄 요약일 수 있습니다. Step 5의 하위 에이전트 프롬프트는 브랜드 값을 직접 붙여넣기 때문에, DESIGN.md의 깊이는 복잡한 구성에만 중요합니다.
게이트: DESIGN.md가 존재함(모든 길이) — 최소한 색상 팔레트, 폰트 선택, do's/don'ts를 포함합니다.
Step 2: 전략 및 메시징
읽기: references/step-2-brief.md, references/capabilities.md (목차 스캔 — 필요한 경우에만 심층 섹션 탐독)
비주얼이나 자산에 대해 이야기하기 전에 사용자와 비디오가 전달해야 할 내용을 조율합니다. 사용자의 프롬프트를 분석합니다 — 아마도 이미 비디오 유형과 스타일을 제공했을 것입니다. 누락된 것만 물어보세요: 이 비디오가 반드시 전달해야 할 단 하나의 메시지, 내러티브 아크, 대상 청중.
게이트: 비디오 유형, 길이, 형식, 그리고 결정적으로 메시지와 내러티브 아크가 확정됩니다. 이것들이 없으면 Step 3에서 개념 우선 스토리보드를 작성할 수 없습니다.
Step 3: 스토리보드 + 대본 💬
읽기: references/step-3-storyboard.md
개념 우선으로 스토리보드를 작성합니다: 메시지 → 내러티브 아크 → 아크에 기여하는 비트 → 비트별 기법 → 마지막에 브랜드 악센트 전달. 그런 다음 내레이션 대본을 일치하도록 작성합니다. 둘 다 비트별 요약과 함께 사용자에게 제시합니다. 사용자가 승인할 때까지 반복합니다.
게이트: STORYBOARD.md + SCRIPT.md가 존재하고 사용자가 계획을 승인했습니다.
Step 4: 보이스오버, 타이밍 + 자막 💬
Step 2에서 내레이션이 없다고 결정된 경우 — 배경 음악에 대해 물어본 후 Step 5로 건너뜁니다. 그렇지 않으면: 사용자에게 어떤 TTS 제공자(HeyGen TTS, ElevenLabs 또는 Kokoro)를 사용할지 묻고, 오디오를 생성하고, 텍스트를 변환하고, 타임스탬프를 비트에 매핑합니다. 그런 다음 자막에 대해 물어봅니다.
게이트: (a) 내레이션이 요청되지 않고 스토리보드에 수동 비트 타이밍이 있거나, (b) narration.wav + transcript.json이 존재하고 비트 타이밍이 실제 지속 시간으로 업데이트되었습니다.
Step 5: 컴포지션 빌드
읽기: hyperframes 스킬 (로드하세요 — 모든 규칙이 중요합니다)
읽기: references/step-5-build.md
Step 3의 스토리보드에서 선택한 아키텍처와 템포에 따라 index.html과 컴포지션을 빌드합니다. 하위 에이전트는 각 비트에 대해 hyperframes lint와 hyperframes snapshot을 실행한 후 보고합니다.
게이트: 모든 compositions/beat-N.html이 메인 에이전트에 의해 DESIGN.md 및 STORYBOARD.md와 비교하여 처음부터 끝까지 읽혔습니다. 비트별 체크리스트는 step-5-build.md에 있습니다.
Step 6: 검증 및 전달
읽기: references/step-6-validate.md
린트, 검증, 비디오 길이에 따라 조정된 스냅샷 촬영(공식: max(비트 수 × 3, ceil(길이_초 / 2))), 각각 검토합니다. 전달하기 전에 문제를 수정합니다. 로컬호스트 Studio 프로젝트 URL을 전달합니다 — 명시적인 사용자 요청이 있을 경우에만 MP4로 렌더링합니다. 해당 Studio URL은 전달 시에만 공개하세요 — 그것은 최종적이고 안정적인 프리뷰입니다; 빌드 단계의 스냅샷은 헤드리스이므로 빌드 중간에 프리뷰를 띄우지 마세요.
자부심을 가지고 전달하세요. 전달하기 전에 스스로에게 물어보세요: 내 이름을 걸고 이 비디오를 소셜 미디어에 올릴 수 있나요? 그렇지 않다면, 문제를 수정하세요.
게이트: npx hyperframes lint 및 npx hyperframes validate가 오류 없이 통과하고, 최종 응답에 활성 Studio 프로젝트 URL이 포함됩니다.
빠른 참조
비디오 유형
비디오 유형별 일반적인 제약 조건 — 공식이 아닌 시작점으로 사용하세요. 비트 수는 대상 범위가 아닌 콘텐츠와 내레이션에 따라 결정되어야 합니다.
| 유형 | 일반적인 길이 | 길이 결정 요인 | 내레이션 |
|---|---|---|---|
| 소셜 광고 (IG/TikTok) | 10–15초 | 플랫폼 제한 | 선택 사항 |
| 제품 데모 | 30–60초 | 대본 길이 | 전체 내레이션 |
| 기능 발표 | 15–30초 | 기능 복잡도 | 전체 내레이션 |
| 브랜드 릴 | 20–45초 | 음악 트랙 | 선택 사항, 음악 중심 |
| 런칭 티저 | 10–20초 | 후크 에너지 | 최소한 |
비트 수는 의도적으로 이 표에 없습니다 — "소셜 광고 = 3-4비트"가 아닌 스토리보드에서 비롯되어야 합니다. 복잡한 제품의 소셜 광고는 5개의 잘 타이밍된 비트가 필요할 수 있습니다. 하나의 강력한 시각적 논제를 가진 브랜드 릴은 3개가 필요할 수 있습니다.
형식
- 가로: 1920x1080 (기본값)
- 세로: 1080x1920 (Instagram Stories, TikTok)
- 정사각형: 1080x1080 (Instagram 피드)
참조 파일
| 파일 | 읽어야 할 시점 |
|---|---|
| step-0-capture.md | Step 0 — 캡처, 브랜드 및 제품 이해, 전략 우선 사이트 요약 작성 |
| step-1-design.md | Step 1 — DESIGN.md 브랜드 치트 시트 작성 (5개 섹션, 250-350줄; 빌보드 스타일 소셜 광고용 50줄 고속 경로) |
| step-2-brief.md | Step 2 — 사용자와 메시지, 내러티브 아크, 대상 청중 조율 |
| capabilities.md | Steps 2 & 5 — HyperFrames가 할 수 있는 전체 인벤토리 (24개 섹션). 브리핑 중 목차를 스캔하고 빌드 중 필요한 특정 섹션을 심층 탐독 |
| step-3-storyboard.md | Step 3 — 스토리보드 + 대본 (결합) 및 사용자 검토 게이트 |
| step-4-vo.md | Step 4 — TTS 제공자 선택, 생성, 타이밍 |
| step-5-build.md | Step 5 — index.html + 컴포지션 빌드 |
| step-6-validate.md | Step 6 — 린트, 검증, 스냅샷 (비디오 길이에 따라 조정), 프리뷰 |
| techniques.md | Steps 3 & 5 — 코드 패턴이 포함된 13가지 기본 애니메이션 기법 (적응, 복사-붙여넣기 금지) |
| html-in-canvas-patterns.md | Step 5 — HTML-in-Canvas 효과를 위한 완전한 코드 패턴 (hyperframes 스킬에 위치) |