Communitygithub.com

hyperframe — 라우터: HeyGen HyperFrames

HeyGen HyperFrames로 가는 얇은 라우터입니다. HTML/CSS/JS를 사용하여 헤드리스 Chrome + FFmpeg로 결정론적 MP4를 렌더링하는 기능을 제공합니다. 사용자가 'hyperframe', 'motion graphics', 'html to video', 'kinetic captions' 등과 같은 키워드를 말할 때 사용합니다.

hyperframe — 라우터: HeyGen HyperFrames란 무엇인가요?

이 스킬은 HeyGen HyperFrames(아파치 2.0 라이선스, github.com/heygen-com/hyperframes)로 가는 **얇은 라우터**입니다. HyperFrames는 HTML/CSS/JS로 작성된 컴포지션을 결정론적 MP4 비디오로 변환합니다. 렌더러는 헤드리스 Chrome에서 각 프레임을 캡처하고 FFmpeg로 인코딩합니다. 이 스킬의 주요 역할은 사용자의 요청 의도를 HyperFrames 리포지토리 내의 적절한 상류 워크플로(예: `/motion-graphics`, `/embedded-captions`, `/hyperframes-cli` 등)로 안내하는 것입니다. 따라서 이 스킬 자체에는 HyperFrames에 대한 심층 지식이 포함되어 있지 않으며, 모든 실제 지식은 복제된 리포지토리와 그 자체의 20개 에이전트 스킬에 있습니다. 사용자가 'make me a video', 'kinetic titles', 'end card', 'animated caption' 등을 요청하면 이 라우터가 적절한 상류 스킬로 연결하여 일관된 워크플로를 보장합니다. 이 스킬은 Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jonosin/jstack/tree/HEAD/skills/hyperframe

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

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

문서

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-captionStayFrame 릴에 일반 정적 텍스트 오버레이가 필요한 경우 — 해당 레인은 헤드리스 Chrome + ffmpeg를 유지하며 HyperFrames가 아닙니다.
/jstack-sf-trim-stitch렌더링된 HyperFrames 오버레이/엔드 카드를 StayFrame 릴로 조합해야 하는 경우.

관련 스킬