HyperFrames, 여기서 시작하세요
HyperFrames는 HTML로 비디오를 렌더링합니다. 컴포지션은 HTML 파일이며, DOM이 data-* 속성으로 타이밍을 선언하고, 애니메이션 런타임을 seek할 수 있으며, 미디어 재생을 프레임워크가 소유합니다. 전체 제작 계약은 /hyperframes-core에 있습니다. 컴포지션 HTML을 작성하기 전에 먼저 읽으세요.
아래에는 역량 지도(주문형 로드되는 도메인 스킬)와 의도 라우터("비디오 만들어 줘" 요청에 대한 워크플로 선택)가 있습니다.
역량 지도. 도메인 스킬
주문형으로 로드되는 원자적 역량: 전체 비디오 워크플로가 아닙니다. "비디오 만들어 줘" 요청은 아래 의도 라우터를 사용하세요.
| 원하는 작업… | 스킬 |
|---|---|
HTML 컴포지션 제작/편집: data-* 계약, 클립, 트랙, 하위 컴포지션, 변수 | /hyperframes-core |
| 애니메이션: 원자적 모션, 씬 청사진, 전환, 런타임 어댑터(GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU) | /hyperframes-animation |
seek-safe 키프레임 제작: GSAP 타임라인, CSS 키프레임, Anime.js, WAAPI, FLIP, 패스, 마스크, SVG 모프/드로우, 3D 깊이, hyperframes keyframes 진단 | /hyperframes-keyframes |
크리에이티브 방향: frame.md / design.md, 팔레트, 타이포그래피, 나레이션, 비트 계획, 오디오 반응형 | /hyperframes-creative |
| 미디어: TTS 음성 해설, 배경 음악, 자막 생성, 배경 제거, 캡션 | /hyperframes-media |
미디어 해결: HeyGen 카탈로그에서 BGM, SFX, 이미지, 아이콘을 찾아 .media/에 고정하고 매니페스트 추적 | /media-use |
| CLI 개발 루프: init, lint, validate, inspect, preview, render, publish, doctor | /hyperframes-cli |
레지스트리 블록/컴포넌트 설치(hyperframes add) | /hyperframes-registry |
| Figma 콘텐츠 가져오기: 에셋, 토큰, 컴포넌트, 스토리보드→애니매틱(REST/CLI); 모션, 셰이더(MCP) | /figma |
의도 라우팅, 워크플로 선택하기
이 섹션은 최상위 워크플로만 알고 있습니다. 내부 참조나 위의 도메인 스킬은 로드하지 않습니다.
라우팅 전, 사양이 아닌 입력을 확인하세요
라우팅은 비디오가 무엇에 관한 것인지 알아야 합니다. 즉, 입력과 주제입니다. 이것이 명시되지 않은 경우("우리 것에 대한 비디오 만들어 줘"라고 하면서 URL, 제품, 주제, 에셋이 없는 경우), 워크플로에 진입하기 전에 질문하세요. 워크플로에 커밋하는 것이 라우팅 결정입니다. 최대 두 가지 질문:
- 입력: 제품(URL/브리프), 일반 웹사이트, GitHub PR, 설명할 주제, 기존 토크헤드 비디오?
기본 사양은 명시하고, 묻지 마세요 (라우트를 변경하지 않음): 화면 비율 16:9(명명된 세로 대상(TikTok/릴스/쇼츠)에만 9:16 사용); 나레이션/캡션 언어 = 사용자의 언어. 선택된 워크플로는 첫 번째 단계에서 자체 세부 사항을 다시 확인합니다.
워크플로 치트 시트
| 워크플로 | 사용 시기 |
|---|---|
/product-launch-video | 제품 판매(SaaS, 앱, 회사/제품 사이트). URL, 브리프 또는 스크립트 → 프로모션. 상업용 URL의 기본값(사이트 이름만 알려진 경우에도). |
/website-to-video | 사이트 자체 보여주기: 사이트 자체 스크린샷으로 구축된 투어/쇼케이스. 비상업적 사이트(포트폴리오, 블로그, 문서, 개인, 이벤트) 또는 사용자가 프로모션이 아닌 투어를 원할 때. |
/faceless-explainer | 주제/개념 설명: 텍스트에서, 제품이나 URL 없음. 모든 시각적 요소는 LLM이 생성. |
/pr-to-video | GitHub PR/코드 변경 → 체인지로그/기능 공개/수정/리팩토링 설명. |
/embedded-captions | 기존 토크헤드 비디오에 캡션/자막 추가(원본 영상 수정 없음). |
/talking-head-recut | 기존 토크헤드 비디오를 디자인된 그래픽 오버레이로 패키징: 하단 서드, 데이터 콜아웃, 모션 타이틀, 풀 인용문. |
/motion-graphics | 짧고 내레이션이 없는 디자인 중심 모션 그래픽: 모션 타이포그래피, 통계/차트 히트, 로고 스팅, 하단 서드 오버레이. |
/music-to-video | 음악 트랙 → 비트 동기화된 비디오, 가사 비디오, 슬라이드쇼 또는 모션 프로모션. 음악이 페이싱을 주도(선택적 사용자 이미지/비디오가 비트 그리드에 맞게 잘림). |
/slideshow | 프레젠테이션/피치 덱/인터랙티브 덱: 개별 슬라이드, 프래그먼트, 분기, 핫스팟. 출력은 탐색 가능한 덱이며, 렌더링된 비디오가 아님. |
/general-video | 기타 모든 것: 더 길거나 여러 씬의 작품, 정적 루프/포스터, 사용자 정의 컴포지션. |
/remotion-to-hyperframes | 기존 Remotion(React) 컴포지션을 HyperFrames로 이식(마이그레이션, 생성 아님). |
혼동 가능한 경우 명확화:
- 모션 우선 및 내레이션 없음(약 10초 미만, 모션 자체가 메시지) →
/motion-graphics, 입력과 관계없음. - URL 또는 스크립트: 한 가지를 질문: 사이트가 제품을 판매하는가? 예(SaaS/앱/제품/회사 사이트) →
/product-launch-video: 프로모션, 상업용 URL(사이트 이름만 알려진 경우에도)의 기본값. 아니오, 또는 사용자가 사이트를 있는 그대로 보여주길 원하는 경우(포트폴리오/블로그/문서/개인/이벤트) →/website-to-video: 투어. GitHub PR 링크 →/pr-to-video; 제품이나 사이트가 없는 개념 →/faceless-explainer. - 기존 영상: 일반 구어체 자막 →
/embedded-captions; 디자인된 오버레이 카드 →/talking-head-recut. 둘 다 영상 자체를 편집하지 않음(타이밍 재조정/색상 변경/프레임 재구성/재정렬/오디오는 NLE 편집으로 범위 밖). - 음악 트랙이 입력(오디오 파일 또는 오디오를 추출할 비디오)이고 내레이션이 없음 →
/music-to-video: 음악의 비트/에너지가 페이싱을 주도. (내레이션이 있는 작품은 위 입력 일치 워크플로 유지;/motion-graphics는 음악 중심이 아닌 짧은 내레이션 없는 모션용.) - 프레젠테이션/피치 덱/인터랙티브 덱(개별 슬라이드, 탐색, 발표자 모드) →
/slideshow: 출력은 탐색 가능한 덱이며, 렌더링된 비디오가 아님. 명시적 "슬라이드쇼" 요청은 직접 진행; 인접 트리거("덱/슬라이드/프레젠테이션/이 페이지 변환")는/slideshow가 슬라이드쇼인지 확인한 후 제작하며, 아니면 적절한 비슬라이드쇼 워크플로로 전환. - 길이는 가이드이지 제한이 아님: 의도가 워크플로를 선택; 작품이 명확히 ~3분보다 길거나 정적/루프/사용자 정의 형식인 경우에만
/general-video로 이동.
일치하는 워크플로가 설치되지 않은 경우
워크플로를 선택한 후, 실제로 사용 가능한지 확인하세요. 일치하는 워크플로 스킬이 설치되지 않은 경우, 추측으로 대체하지 말고 사용자에게 먼저 설치하라고 알리세요:
- 이 워크플로만:
npx skills add heygen-com/hyperframes --skill <workflow-name>(예:--skill pr-to-video: 이름만, 앞에/없음). - 모든 워크플로 한 번에:
npx skills add heygen-com/hyperframes --all(핵심 + 모든 워크플로, 선택기 건너뜀).
실행 후 워크플로의 스킬을 다시 읽고 계속하세요.
스킬 최신 상태 유지
HyperFrames 스킬은 버전 관리됩니다. npx hyperframes init는 설치된 스킬을 GitHub의 최신 버전과 비교하여, 무언가 오래되었거나 누락된 경우 전체 세트를 설치/새로고침합니다. 따라서 새로 init된 프로젝트는 항상 완전하고 최신 세트를 가지며(최신 프로젝트에서 init 재실행은 아무 작업도 하지 않음). 확인은 빠른 GitHub 왕복이며, 오프라인(또는 속도 제한) 상태에서는 짧은 시간 초과 후 설치로 대체되므로 init이 네트워크 문제로 하드 실패하지 않습니다. 생성 워크플로는 init으로 스캐폴딩되므로, 새 프로젝트를 시작할 때마다 이 확인을 실행하고 GitHub에서 최신 스킬을 가져옵니다. --skip-skills 플래그는 현재 무력화되어 있습니다(skills.sh 레지스트리가 따라잡는 동안의 임시 조치). 전달해도 확인을 건너뛰지 않으므로 모든 init이 GitHub를 확인합니다. CI/테스트는 HYPERFRAMES_SKIP_SKILLS=1 환경 변수를 통해 옵트아웃합니다.
작업이 예상치 못하게 동작하거나 긴 빌드 전에 설치된 스킬이 최신인지 확인하세요:
- 확인:
npx hyperframes skills check(--json추가 시 기계 판독 가능한 결과; 무언가 오래되었거나 누락된 경우 0이 아닌 종료 코드 반환). - 업데이트:
npx hyperframes skills update: 전체 세트를 최신 버전으로 가져오며, 아직 없는 것은 설치(init의 설치 단계와 동일).
CLI는 render/lint/validate 실행 시 오래된 스킬을 감지하면 한 줄 알림을 표시합니다.
워크플로 세부 정보
/product-launch-video
- 입력: 마케팅 중인 제품: (a) 제품 URL(헤드리스 Chrome으로 크롤링하여 에셋 + 브랜드 토큰 획득), (b) 제품 사이트를 명명하는 스크립트/브리프(링크가 없어도 PLV가 해결 + 크롤링, 사용자가 거부하지 않는 한), 또는 (c) 사이트를 유추할 수 없거나 "스크랩하지 마세요"인 스크립트(캡처 없음 모드, 팔레트 + 디자인 시스템을 제공하는 스타일 프리셋 선택). 제공된 스크립트는 그대로 음성 해설 또는 씬별로 재구성될 수 있습니다. PLV가 묻습니다.
- 출력: 제품 출시/SaaS 프로모션을 HyperFrames 컴포지션으로 → MP4 (최적 길이 30-90초). 제품의 가치가 주제이며, 사이트 둘러보기가 아닙니다. 단순 사이트 투어는
/website-to-video를 사용하세요. - 트리거: "X에 대한 런치 비디오", "우리 사이트 프로모션", "내 SaaS를 1분 안에 설명", "내 스크립트를 60초 프로모션으로", "텍스트 전용 런치 비디오, 스크랩하지 마세요".
/website-to-video
- 입력: 목표가 사이트 자체를 보여주는 것이지 제품을 판매하는 것이 아닌 웹사이트/URL. 비상업적 사이트(포트폴리오, 블로그, 문서, 개인, 이벤트)에 가장 적합하거나, 사용자가 명시적으로 사이트를 있는 그대로 투어하기를 원할 때. 헤드리스 Chrome으로 실제 스크린샷 + 브랜드 에셋을 캡처합니다. 사이트가 무언가를 판매하고 사용자가 프로모션을 원하는 경우
/product-launch-video를 사용하세요. - 출력: 사이트 자체의 시각적 요소로 구축된 사이트 투어/쇼케이스/소셜 클립 → MP4.
- 트리거: "이 웹사이트를 비디오로 만들어 줘", " 사이트 투어", "우리 홈페이지 소셜 클립", "URL만 있어, 뭔가 만들어 줘".
/faceless-explainer
- 입력: 임의의 텍스트. 설명되는 주제, 기사 또는 노트로, 마케팅되는 제품이나 캡처할 사이트가 없음. (
/product-launch-video에서 분기; 헤드리스 Chrome 없음.) - 출력: 얼굴 없는 설명 비디오 → MP4, 모든 시각적 요소는 씬별로 LLM이 생성(타이포그래피/추상/다이어그램/데이터 시각화);
pin-and-paper프리셋 제공. (최적 길이 30-90초). - 트리거: "X에 대한 얼굴 없는 설명", "DNS가 어떻게 작동하는지 비디오로 설명", "이 기사를 설명 비디오로", "내 노트로 설명 비디오".
/pr-to-video
- 입력: GitHub 풀 리퀘스트: PR URL,
소유자/저장소#N참조, 또는 "이 PR".ghCLI를 통해 읽음(스크래핑할 사이트가 아님). - 출력: 코드 변경 설명 비디오(체인지로그/기능 공개/수정/리팩토링) → MP4, diff 하이라이트, 전/후, 파일 트리 + 영향 씬. (최적 길이 30-90초).
- 트리거: "이 PR에 대한 비디오 만들어 줘", "PR #1187을 체인지로그 비디오로", "github.com/org/repo/pull/123에서 릴리스 노트 비디오".
/embedded-captions
- 입력: 자막을 추가할 기존 토크헤드 비디오(MP4), 실제 영상이며 URL이나 브리프가 아님. 로컬로 전사(Whisper, API 키 불필요) 및 매트 처리(RVM)하여 주제가 캡션을 가릴 수 있음.
- 출력: 동일한 영상 수정 없음, 캡션 레이어 추가: 표준(원문 그대로 하단 서드 레일 + 주제 뒤에 임베디드 클라이맥스) 또는 시네마틱(모든 캡션이 주제 뒤에 합성됨). 모든 길이.
- 트리거: "이 비디오에 캡션/자막 추가", "주제 뒤에 캡션", "내 클립에 시네마틱 캡션".
/talking-head-recut
- 입력: 화면 그래픽으로 패키징할 기존 토크헤드/인터뷰/팟캐스트 비디오(MP4), 실제 영상. 로컬로 전사(Whisper). 클립은 그대로 아래에서 전체 재생.
- 출력: 동일한 영상에 시간이 지정된 그래픽 오버레이 카드 추가: 모션 타이틀, 하단 서드, 데이터 콜아웃, 풀 인용문, 사이드 패널, PIP, 동기화
… [번역을 위해 잘림]