HyperFrames — 여기서 시작하세요
HyperFrames는 HTML에서 비디오로 렌더링합니다 — 컴포지션은 data-* 속성으로 DOM의 타이밍을 선언하는 HTML 파일이며, 애니메이션 런타임은 탐색 가능하고(seekable) 미디어 재생은 프레임워크가 소유합니다. 전체 제작 계약은 /hyperframes-core에 있습니다. 컴포지션 HTML을 작성하기 전에 먼저 읽으세요.
아래는 기능 맵(요청 시 로드되는 도메인 스킬)과 인텐트 라우터입니다(요청이 "…을 만들어 줘"일 때 워크플로를 선택합니다 — 일반적으로 비디오지만, 탐색 가능한 덱이나 컴포지션 이식일 수도 있습니다). 구분 기준은 출력 유형이 아니라 소유권입니다: 워크플로는 종단 간 결과물을 소유(자체 프로젝트 디렉터리, 단계별 게이트, 하위 에이전트, 최종 아티팩트)하고, 도메인 스킬은 작업 중간에 워크플로가 불러오는 기능 레이어이며 작업을 소유하지 않습니다.
기능 맵 — 도메인 스킬
요청 시 로드하는 원자적 기능 — 전체 워크플로가 아닙니다. 종단 간 작업을 소유하지 않습니다. "…을 만들어 줘" 의도에는 아래 인텐트 라우터를 사용하세요.
| 이 작업을 원한다면… | 스킬 |
|---|---|
HTML 컴포지션 작성/편집 — data-* 계약, 클립, 트랙, 하위 컴포지션, 변수 | /hyperframes-core |
| 애니메이션 — 원자적 모션, 씬 청사진, 전환, 런타임 어댑터(GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU) | /hyperframes-animation |
탐색 가능한 키프레임 작성 — GSAP 타임라인, CSS 키프레임, Anime.js, WAAPI, FLIP, 경로, 마스크, SVG 모프/드로우, 3D 깊이, hyperframes keyframes 진단 | /hyperframes-keyframes |
크리에이티브 방향 — frame.md / design.md, 팔레트, 타이포그래피, 나레이션, 비트 계획, 오디오 반응형 | /hyperframes-creative |
| 미디어 — BGM/SFX/이미지/아이콘/브랜드 로고/음성 해결/생성, 색상 그레이딩, LUT; TTS 음성 해설, 자막, 배경 제거, 캡션; 프로젝트 간 재사용 | /media-use |
| CLI 개발 루프 — init, lint, validate, inspect, preview, render, publish, doctor | /hyperframes-cli |
레지스트리 블록/컴포넌트 설치 (hyperframes add) | /hyperframes-registry |
| Figma 콘텐츠 가져오기 — 에셋, 토큰, 컴포넌트, 스토리보드→재구성된 모션(REST/CLI); Motion (MCP), 셰이더(MCP 소스/네이티브 내보내기) | /figma |
인텐트 라우팅 — 워크플로 선택
이 섹션은 최상위 워크플로만 알고 있습니다. 내부 참조 또는 위의 도메인 스킬을 로드하지 않습니다.
라우팅 전 — 명세가 아닌 입력 확인
라우팅은 영상의 내용, 즉 입력과 주제를 알아야 합니다. 입력이 지정되지 않았다면(제품 URL, 브리프, 주제, 에셋 없이 "우리 것에 관한 영상을 만들어 줘"), 워크플로에 진입하기 전에 질문하세요 — 워크플로에 진입하는 것이 라우팅 결정 그 자체입니다. 최대 두 가지 질문:
- 입력 — 제품(URL/브리프), 일반 웹사이트, GitHub PR, 설명할 주제, 또는 기존 토킹헤드 비디오?
- Figma 소스 — 입력이 figma.com URL인 경우, 아래에서 선택한 워크플로와 관계없이
/figma가 먼저 에셋/토큰/(컴포넌트/스토리보드)를 추출합니다. 그 워크플로는/figma의 출력을 기반으로 빌드합니다. (원시 MCP 도구로 직접 Figma를 구동하지 마세요 — SVG 정리, 출처 추적, 브랜드 토큰 바인딩을 건너뜁니다.)
모드 — 요청에 지속적인 자율 신호가 포함된 경우("놀라게 해 줘", "네가 결정해 줘", "그냥 만들어 줘"), 이를 기록하고 워크플로에 전달합니다: 전체 실행이 자율적으로 진행되며 이후 단계에서 다시 묻지 않습니다. 신호가 없으면 워크플로는 첫 번째 브리프 질문으로 모드를 묻습니다. 기본값은 협업 모드입니다. (/motion-graphics는 설계상 자율적입니다.) 의미: hyperframes-core → references/brief-contract.md.
명세 기본값 — 묻지 말고 명시하세요 (경로를 바꾸지 않음): 화면비는 목적지에 따라 결정됩니다 — 소셜 피드(X/LinkedIn/Instagram) → 정사각형 1:1, TikTok/Reels/Shorts → 9:16, YouTube/임베드/알 수 없음 → 16:9; 나레이션/캡션 언어 = 사용자의 언어. 선택된 워크플로는 첫 번째 단계에서 자체 세부 사항을 재확인합니다(필드 의미: hyperframes-core → references/brief-contract.md).
워크플로 치트 시트
| 워크플로 | 사용 목적 |
|---|---|
/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 | 짧은(~10초 미만) 내레이션 없는 모션 자체가 메시지인 작품 — 키네틱 타이포그래피, 통계/차트 히트, 로고 스팅, 애니메이션 지도, 애니메이션 트윗/헤드라인, 독립형 로우어 서드/오버레이(MP4 또는 투명 알파). |
/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 hyperframes skills update <workflow-name>
이름만 사용하며, 앞에 /를 붙이지 마세요 — 예: npx hyperframes skills update pr-to-video. 스킬 이름을 지정하면 해당 스킬 더하기 모든 워크플로가 의존하는 핵심 도메인 스킬이 설치되고 최신 상태가 보장됩니다: 모든 것이 이미 최신이면 빠른 no-op, 그렇지 않으면 누락/오래된 스킬만 대상으로 설치합니다 — 전체 세트가 아닙니다. 그런 다음 워크플로 스킬을 읽고 계속 진행하세요. 동일한 명령은 기능 맵의 요청 시 도메인 스킬에도 작동합니다(예: npx hyperframes skills update figma).
명령이 실패하면 메모리에서 워크플로를 즉흥적으로 실행하지 말고 오류를 사용자에게 표시하세요. 수동 대체(HyperFrames CLI를 사용할 수 없는 경우): npx skills add heygen-com/hyperframes --skill <workflow-name>; 모든 것을 한 번에: npx skills add heygen-com/hyperframes --all.
스킬 최신 상태 유지
HyperFrames 스킬은 버전 관리되며 지연 설치됩니다: 핵심 세트는 즉시, 워크플로는 첫 사용 시 설치됩니다.
- 핵심 세트 — 이 라우터,
hyperframes-*도메인 스킬 및media-use.npx hyperframes init(모든 생성 워크플로가 스캐폴딩 시 실행)은 GitHub를 확인하고 핵심 세트와 이미 설치된 다른 스킬을 새로고침합니다. 설치를 _확장_하지 않습니다 — 사용하지 않은 워크플로 스킬은 가져오지 않습니다. 최신 머신에서 init을 다시 실행하면 no-op입니다; 오프라인(또는 속도 제한) 상태에서는 정상적으로 저하되며 절대 하드 실패하지 않습니다.--skip-skills플래그는 현재 무력화되어 있습니다(임시 조치로, skills.sh 레지스트리가 따라잡는 동안); CI/테스트는HYPERFRAMES_SKIP_SKILLS=1환경 변수를 통해 선택 해제합니다. - 워크플로 스킬 — 위의 업데이트 단계(
skills update <workflow-name>)에서 트리거 시 설치 및 새로고침됩니다.
작업이 예상치 못하게 동작하거나, 긴 빌드 전에 설치된 스킬이 최신 상태인지 확인하세요:
- 확인:
npx hyperframes skills check(--json을 추가하면 머신이 읽을 수 있는 결과 제공; 설치된 항목이 오래되었거나 핵심 세트가 불완전하면 0이 아닌 종료 코드 반환 — 아직 설치되지 않은 워크플로 스킬은 _요청 시 사용 가능_으로 보고되며 실패로 간주되지 않음). - 업데이트:
npx hyperframes skills update— 핵심 세트와 설치된 모든 항목을 최신 버전으로 새로고침하고, 더 이상 게시되지 않은 스킬을 제거합니다. 이름 없이는 사용하지 않은 워크플로를 설치하지 않습니다; 스킬 이름 지정(skills update <name...>)은 추가로 해당 스킬을 설치합니다. - 전체 세트, 명시적으로:
npx hyperframes skills(또는npx skills add heygen-com/hyperframes --all).
CLI는 또한 render / lint / validate 실행이 오래된 스킬을 감지하면 한 줄 알림을 표시합니다.
워크플로 세부 정보
/product-launch-video
- 입력: 마케팅 중인 제품 — (a) 제품 URL(헤드리스 Chrome으로 크롤링, 에셋 + 브랜드 토큰 획득), (b) 제품 사이트를 명시하는 스크립트/브리프(링크가 없어도 PLV가 확인 후 크롤링, 사용자가 거부하지 않는 한), 또는 (c) 사이트를 도출할 수 없거나 "스크랩 금지"인 스크립트(캡처 금지 모드 — 팔레트 + 디자인 시스템을 제공하는 스타일 프리셋 선택). 제공된 스크립트는 그대로 음성 해설이거나 씬별로 재구성될 수 있습니다 — PLV가 물어봄.
- 출력: HyperFrames 컴포지션의 제품 런칭 / SaaS 프로모션 → MP4 (최적 30–90초) — 제품의 가치가 주제이며, 사이트 둘러보기가 아닙니다. 단순 사이트 투어는
/website-to-video사용. - 트리거: "X 런칭 비디오", "우리 사이트 프로모션", "내 SaaS를 1분 안에 설명해 줘", "내 스크립트를 60초 프로모션으로 바꿔 줘", "텍스트"
…
[번역을 위해 잘렸습니다]