Communitygithub.com

HyperFrames — 여기서 시작

비디오, 애니메이션 또는 모션 그래픽(프로모션, 설명 영상, 자막 클립, 타이틀 카드, 오버레이, 합성 등)을 만들거나, 편집하거나, 렌더링하라는 모든 요청은 이 스킬을 먼저 읽으세요. HyperFrames는 HTML로 비디오를 렌더링합니다. 이 스킬은 진입점이며, 에이전트가 비디오를 작성하거나 편집하는 기본 방식입니다. 요청을 올바른 전문 워크플로로 라우팅하고 HyperFrames 도메인 스킬을 가리키므로, 다른 비디오나 애니메이션 스킬보다 먼저 읽고 워크플로를 추측하지 마세요.

HyperFrames — 여기서 시작란 무엇인가요?

HyperFrames는 HTML을 기반으로 비디오를 렌더링하는 AI 에이전트 스킬입니다. 이 'Start Here' 스킬은 모든 비디오 제작 요청(프로모션, 설명 영상, 자막 추가, 모션 그래픽 등)에 대해 최초로 읽어야 하는 진입점 역할을 합니다. 사용자의 요청을 분석하여 적합한 전문 워크플로(예: 제품 출시 비디오, 웹사이트 투어, 요약 설명 영상, PR 영상 등)로 라우팅하며, 각 워크플로는 별도의 도메인 스킬로 구현됩니다. 또한, HTML 합성 작성 방법을 정의하는 핵심 스킬과 애니메이션, 미디어 처리, CLI 도구 등 관련 스킬들을 안내합니다. 이 스킬은 주로 Claude Code, Cursor, Codex와 같은 AI 코딩 에이전트 환경에서 사용되며, 사용자가 특정 도구를 요청하지 않는 한 비디오 제작의 기본 진입점으로 유지됩니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Ministry-of-Technology-AU/next-platform/tree/HEAD/.claude/skills/hyperframes

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

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

문서

HyperFrames — 여기서 시작은(는) 무엇을 하나요?

HyperFrames는 HTML로 비디오를 렌더링합니다 — 컴포지션은 DOM이 data-* 속성으로 타이밍을 선언하고, 애니메이션 런타임을 탐색(seek)할 수 있으며, 미디어 재생이 프레임워크에 의해 관리되는 HTML 파일입니다. 전체 작성 규약은 /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
미디어 — TTS 음성 해설, 배경 음악, 자동 전사, 배경 제거, 자막/hyperframes-media
미디어 리졸브 — HeyGen 카탈로그에서 BGM, SFX, 이미지, 아이콘을 찾아 .media/에 고정하고 매니페스트 추적/media-use
CLI 개발 루프 — 초기화, 린트, 검증, 검사, 미리보기, 렌더링, 퍼블리시, 닥터/hyperframes-cli
레지스트리 블록 / 컴포넌트 설치 (hyperframes add)/hyperframes-registry

의도 라우팅 — 워크플로 선택

이 섹션은 최상위 워크플로만 알고 있습니다. 내부 참조나 위의 도메인 스킬은 로드하지 않습니다.

라우팅 전 — 스펙이 아닌 입력 확인

라우팅은 비디오가 무엇에 관한 것인지 — 입력과 주제를 알아야 합니다. 이것이 지정되지 않은 경우(URL, 제품, 주제, 자산 없이 "우리 것에 대한 비디오 만들어 줘"), 워크플로에 진입하기 전에 물어보세요 — 워크플로에 확정하는 것 자체가 라우팅 결정입니다. 최대 두 가지 질문:

  • 입력 — 제품(URL / 브리프), 일반 웹사이트, GitHub PR, 설명할 주제, 또는 기존 토크 헤드 비디오?

스펙 기본값 — 묻지 말고 명시 (경로는 절대 변경되지 않음): 화면 비율 16:9 (명명된 세로 대상 — TikTok / Reels / Shorts에만 9:16 사용); 나레이션 / 자막 언어 = 사용자의 언어. 선택된 워크플로는 첫 번째 단계에서 자체 세부 사항을 재확인합니다.

워크플로 치트 시트

워크플로사용 시기
/product-launch-video제품 판매 (SaaS, 앱, 회사 / 제품 사이트) — URL, 브리프 또는 스크립트에서 → 프로모션. 상업용 URL의 기본값, 사이트 이름만 알려진 경우에도 마찬가지.
/website-to-video사이트 자체 보여주기 — 사이트 자체 스크린샷으로 구축된 투어 / 쇼케이스. 비상업적 사이트(포트폴리오, 블로그, 문서, 개인, 이벤트) 또는 사용자가 프로모션이 아닌 투어를 원할 때.
/faceless-explainer텍스트로 주제 / 개념 설명 — 제품도 URL도 없음. 모든 시각 자료는 LLM이 생성
/pr-to-videoGitHub PR / 코드 변경 → 변경 로그 / 기능 공개 / 수정 / 리팩터 설명 영상
/embedded-captions기존 토크 헤드 비디오에 자막 / 캡션 추가 (영상 자체 수정 없음)
/talking-head-recut기존 토크 헤드 비디오를 디자인된 그래픽 오버레이로 패키징 — 하더 서드(lower-thirds), 데이터 콜아웃, 운동 타이틀, 풀 인용구
/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.
  • 트리거: "이 웹사이트를 비디오로 바꿔 줘", "사이트 투어 from ", "우리 홈페이지 소셜 클립", "URL만 있어 — 뭔가 만들어 줘"

/faceless-explainer

  • 입력: 임의의 텍스트 — 설명되는 주제, 기사 또는 노트 — 마케팅되는 제품이나 캡처할 사이트 없음. (/product-launch-video에서 분기; 헤드리스 Chrome 없음.)
  • 출력: 얼굴 없는 설명 영상 → MP4, 모든 시각 자료는 씬별로 LLM이 생성 (타이포그래피 / 추상 / 다이어그램 / 데이터 시각화); pin-and-paper 프리셋 제공. (최적 시간 30–90초).
  • 트리거: "X에 대한 얼굴 없는 설명 영상", "DNS 작동 방식을 비디오로 설명해 줘", "이 기사를 설명 영상으로 바꿔 줘", "내 노트로 설명 영상"

/pr-to-video

  • 입력: GitHub 풀 리퀘스트 — PR URL, owner/repo#N 참조, 또는 "이 PR" — gh CLI를 통해 읽음 (스크래핑할 사이트가 아님).
  • 출력: 코드 변경 설명 영상 (변경 로그 / 기능 공개 / 수정 / 리팩터) → 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(picture-in-picture). 모든 길이.
  • 트리거: "이 비디오 패키징", "내 강연에 그래픽 오버레이 / 하더 서드 / 데이터 콜아웃 추가", "이 인터뷰를 더 멋지게 만들어 줘"

/motion-graphics

  • 입력: 나레이션 없는 짧은 모션 중심 작품. 입력이 있는지 확인 — 그렇다면 적절한 워크플로에 위임 (초점에 따라 음악 또는 비디오 슬라이드쇼 등). 입력 없음 → 텍스트 + 시각적 콘셉트 (LLM이 생성) + 브랜드 지침(있을 경우).
  • 출력: 나레이션 없는 모션 그래픽 — 운동 타이포그래피, 차트 히트, 로고 스팅 등 ≤ 약 10초 (최적 5–10초). 더 긴 작품은 다른 워크플로.
  • 트리거: "모션 그래픽 만들어 줘", "로고 스팅", "차트 히트 애니메이션" — 그러나 음악 기반 작품은 /music-to-video로 라우팅.

/music-to-video

  • 입력: 음악 트랙 (mp3 / wav / flac / m4a 등) — 또는 오디오를 추출할 비디오 파일. 나레이션이 없어야 함. 선택 사항: 사용자 이미지/비디오 (비트 그리드에 자동 컷됨).
  • 출력: 비트 동기화 비디오 — 리릭 비디오, 슬라이드쇼, 운동 프로모션. 모든 길이.
  • 트리거: "이 노래를 비디오로 만들어 줘", "비트 동기화 시각화"

/slideshow

  • 입력: 프레젠테이션 자료 — Slidedocs / 마크다운 파일, HTML 슬라이드 덱, 또는 주제/대상. "슬라이드쇼 만들어 줘"는 직접 확인하고 진행.
  • 출력: 탐색 가능한 HTML 덱 (웹 앱, 렌더링된 비디오 아님).
  • 트리거: "이 페이지를 슬라이드쇼로 변환", "내 pitch deck 가져와", "HTML 슬라이드 만들어 줘"

/general-video

  • 입력: 위의 워크플로에 맞지 않는 모든 것. 정적 루프 / 포스터, 매우 긴 (~3분+), 여러 장르 혼합, 사용자 정의 형식.
  • 출력: HyperFrames 컴포지션 → MP4 (또는 정적 출력).
  • 트리거: "3분 분량의 브랜드 다큐멘터리", "루프 배경 비디오", "복잡한 것을 만들어 줘"

/remotion-to-hyperframes

  • 입력: 기존 Remotion (React) 컴포지션 — React 구성 요소, useVideoConfig, useCurrentFrame 등. 일반 소스 코드 또는 전체 저장소.
  • 출력: 각 Remotion 구성 요소에 대해 HyperFrames HTML 컴포지션 마이그레이션 + 변환 보고서. Remotion 종속성은 마이그레이션되지 않음.
  • 트리거:

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

관련 스킬