hyperframe — 라우터: HeyGen HyperFrames은(는) 무엇을 하나요?
HyperFrames(Apache-2.0, github.com/heygen-com/hyperframes)는 HTML/CSS/JS 컴포지션을 결정론적 MP4로 변환합니다. 렌더러는 헤드리스 Chrome에서 각 프레임을 캡처하고 FFmpeg로 인코딩합니다. 이 스킬은 얇은 라우터입니다. 모든 실제 지식은 복제된 리포지토리와 그 자체의 20개 에이전트 스킬에 있습니다. 여기서 상류 문서를 복제하지 마십시오.
로컬 경로
해상도: HYPERFRAMES_HOME 환경 변수 → ~/.jstack/config.env → 아래 기본값.
| 항목 | 위치 |
|---|---|
| 복제된 리포지토리(표준 로컬 복사본) | ~/.jstack/vendor/hyperframes |
| 상류 라우터 스킬 (비디오 제작 요청 시 가장 먼저 읽을 것) | ~/.jstack/vendor/hyperframes/skills/hyperframes/SKILL.md |
자체 20개 에이전트 스킬 (hyperframes init에 의해 ~/.claude/skills/ + ~/.agents/skills/에도 설치됨) | ~/.jstack/vendor/hyperframes/skills/ |
블록/컴포넌트 레지스트리 (70개 이상의 블록: lower-thirds lt-*, code-*, logo-outro, glitch, data-chart…) | ~/.jstack/vendor/hyperframes/registry/{blocks,components} |
| 문서 소스 (퀵스타트, 개념, 참조, 카탈로그) | ~/.jstack/vendor/hyperframes/docs/ |
| 온라인: 문서 + 블록 카탈로그 | hyperframes.heygen.com (퀵스타트/문서/카탈로그), hyperframes.dev (플레이그라운드 + 디자인 템플릿) |
설치 / 상태 확인
요구 사항: Node 22+ 및 PATH에 FFmpeg (이 머신에서 확인됨, CLI v0.7.48).
npx --yes hyperframes doctor # 환경 상태 확인
npx --yes hyperframes init my-video # 프로젝트 스캐폴딩 (에이전트 스킬도 설치/갱신)
cd my-video && npm run render # → renders/*.mp4
init은 index.html + hyperframes.json을 스캐폴딩하고 package.json 스크립트(dev/check/render/publish)에 CLI 버전을 고정합니다. 복제본을 새로고침하려면 다음을 실행하세요:
git -C ~/.jstack/vendor/hyperframes pull
디스패치 테이블
의도를 라우팅한 후 상류 대상을 열거나 실행하십시오. 워크플로를 즉석에서 만들지 마십시오.
| 의도 | 이동 대상 |
|---|---|
| "비디오/애니메이션 제작" 요청 (진입점) | /hyperframes 라우터 스킬 읽기: ~/.jstack/vendor/hyperframes/skills/hyperframes/SKILL.md — 워크플로 선택 |
| 애니메이션 훅 텍스트 / 키네틱 타이틀 / 스탯 히트 / 로고 스팅 / 엔드 카드 / 로우더 서드 (짧고, 내레이션 없음, 디자인 중심) | /motion-graphics 워크플로: 클론 내 skills/motion-graphics/; 로우더 서드 블록 = 레지스트리 lt-*, 엔드 카드 = logo-outro |
| 기존 토킹헤드 비디오에 키네틱 캡션/자막 | /embedded-captions 워크플로: skills/embedded-captions/ (원본 영상은 그대로 두고 캡션을 오버레이 렌더링) |
HTML→MP4 컴포지션 제작 또는 편집 (data-* 타이밍 계약, 클립, 트랙) | /hyperframes-core → /hyperframes-animation: skills/hyperframes-core/, skills/hyperframes-animation/ |
| 블록 및 컴포넌트 찾아보기/설치 | 레지스트리 디렉토리 registry/{blocks,components} 또는 hyperframes.heygen.com/catalog; 설치 및 연결: /hyperframes-registry 및 npx hyperframes add [block] |
| 컴포지션 렌더링 / 미리보기 / 린트 / 검증 | /hyperframes-cli: npx hyperframes preview, npx hyperframes lint && npx hyperframes validate, npx hyperframes render, npx hyperframes doctor |
| 컴포지션의 BGM / SFX / 음성 해설 / 아이콘 / 배경 제거 | /media-use: skills/media-use/ |
| 덱/슬라이드쇼, 제품 프로모, PR-to-video, 음악 싱크, 웹사이트 투어, Remotion 포팅 | skills/ 내의 일치하는 워크플로 스킬 (/hyperframes 라우터의 치트 시트 참조) |
사용하지 말아야 할 경우 (StayFrame 레드 라인)
StayFrame의 피드 미학적 노스스타(ADR 0002, 편집-미니멀 — "이것이 Aman/Soneva 그리드에서 눈에 띄지 않을까?")는 과도한 모션 그래픽 스타일을 브랜드에 맞지 않게 만듭니다: Hormozi 스타일 키네틱 캡션, 글리치/VFX 블록, 뉴스 티커, 액체 유리 위젯. StayFrame 릴에는 HyperFrames를 미묘한 최소 오버레이에만 사용하고 다음을 유지하십시오:
- 정적 텍스트 오버레이는 기존 레인에 유지 — 헤드리스 Chrome + ffmpeg via
/jstack-sf-caption. HyperFrames로 마이그레이션하지 마십시오. - 생성형 비디오 (i2v/t2v)는 절대 HyperFrames가 아님 — 이것은
/vidgen입니다.
주의 사항
hyperframes init에는--yes플래그가 없습니다 (알 수 없는 플래그는 오류 발생); 이미 비대화형입니다.init부작용: HyperFrames 자체 핵심 스킬을~/.claude/skills/및~/.agents/skills/에 설치/갱신합니다. 예상된 동작이며, 상류 라우터를 최신 상태로 유지합니다.- 스킬 단독 설치:
npx skills add heygen-com/hyperframes --full-depth—--full-depth를 유지하지 않으면main보다 뒤쳐진 오래된 skills.sh 레지스트리 블롭이 생깁니다. - 텔레메트리는 기본적으로 활성화되어 있습니다. 비활성화하려면
hyperframes telemetry disable. - 렌더 출력은 프로젝트 디렉토리 내
renders/[프로젝트명]_[타임스탬프].mp4에 저장됩니다.
다음 스킬
| 다음 | 조건 |
|---|---|
/vidgen | 컴포지션에 생성된 푸티지(i2v/t2v 클립)가 소스 미디어로 필요한 경우 — 비디오 생성은 항상 이곳으로 라우팅되며, 백엔드로 직접 가지 않습니다. |
/jstack-sf-caption | StayFrame 릴에 일반 정적 텍스트 오버레이가 필요한 경우 — 해당 레인은 헤드리스 Chrome + ffmpeg를 유지하며 HyperFrames가 아닙니다. |
/jstack-sf-trim-stitch | 렌더링된 HyperFrames 오버레이/엔드 카드를 StayFrame 릴로 조합해야 하는 경우. |