Communitygithub.com

HyperFrames — 여기서 시작

비디오, 애니메이션, 모션 그래픽(프로모션, 설명 영상, 자막 클립, 타이틀 카드, 오버레이, 슬라이드쇼/인터랙티브 덱 등 모든 종류의 합성)을 만들거나, 편집하거나, 렌더링하거나, 애니메이션화하는 모든 요청에 대해 가장 먼저 읽어야 할 스킬입니다. HyperFrames는 HTML로 비디오를 렌더링합니다. 이 스킬은 엔트리 스킬이자 에이전트가 비디오를 작성하거나 편집하는 기본 방식이므로, 워크플로를 추측하지 말고 다른 비디오/애니메이션 스킬을 읽기 전에 이 스킬을 먼저 읽으십시오.

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

HyperFrames는 HTML을 사용하여 비디오를 렌더링하는 AI 에이전트 스킬입니다. 이 스킬은 `data-*` 속성을 통해 DOM 타이밍을 선언하는 HTML 파일을 기반으로 하며, 시크 가능한 애니메이션 런타임과 프레임워크가 소유하는 미디어 재생을 제공합니다. 전체 제작 계약은 `/hyperframes-core` 도메인 스킬에 정의되어 있습니다. 이 스킬의 핵심은 요청을 적절한 워크플로우로 라우팅하는 **의도 라우터(intent router)** 입니다. 사용자가 "비디오를 만들어 줘"라고 요청하면, 이 스킬은 입력값(제품 URL, 웹사이트, 주제, 기존 영상 등)을 확인하고 가장 적합한 워크플로우(예: 제품 런칭 비디오, 웹사이트 투어, 설명 영상, 자막 추가, 모션 그래픽 등)를 선택합니다. 라우팅이 결정되면 해당 워크플로우 스킬을 필요 시 설치하고 실행합니다. HyperFrames는 **지연 설치(lazy install)** 방식을 사용합니다. 핵심 스킬은 미리 설치되고 워크플로우 스킬은 처음 사용될 때 설치됩니다. 이 스킬은 워크플로우 선택 시 `npx hyperframes skills update <workflow-name>` 명령어를 통해 필요한 스킬이 설치되어 있는지 확인하고, 설치되지 않은 경우 자동으로 설치합니다. CLI 명령어(`npx hyperframes init`, `skills update`, `skills check`)를 통해 스킬 버전을 관리하고 최신 상태로 유지할 수 있습니다. 주요 워크플로우로는 `/product-launch-video` (제품 프로모션), `/website-to-video` (웹사이트 투어), `/faceless-explainer` (주제 설명), `/motion-graphics` (모션 중심 짧은 영상), `/slideshow` (프레젠테이션 덱) 등이 있으며, 각 워크플로우는 고유한 입력과 출력 형식을 가집니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/childelins/feishu-pi-bridge/tree/HEAD/pi/agent/skills/hyperframes

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

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

문서

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

HyperFrames는 HTML로 비디오를 렌더링합니다. 컴포지션은 DOM이 data-* 속성으로 타이밍을 선언하고, 애니메이션 런타임이 탐색 가능하며, 미디어 재생이 프레임워크에 의해 소유되는 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
미디어 — BGM, SFX, 이미지, 아이콘, 브랜드 로고, 음성 해결/생성; TTS 음성, 자막, 배경 제거, 캡션; 프로젝트 간 재사용/media-use
CLI 개발 루프 — 초기화, 린트, 검증, 검사, 미리보기, 렌더링, 게시, 닥터/hyperframes-cli
레지스트리 블록/컴포넌트 설치 (hyperframes add)/hyperframes-registry
Figma 콘텐츠 가져오기 — 에셋, 토큰, 컴포넌트, 스토리보드→재구성된 모션 (REST/CLI); Motion (MCP), 셰이더 (MCP 소스 / 네이티브 내보내기)/figma

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

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

라우팅 전 — 명세가 아닌 입력을 확인하십시오

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

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

모드 — 요청에 지속적인 자율 신호가 포함된 경우 ("놀라게 해 줘", "나를 위해 결정해 줘", "그냥 만들어 줘") 이를 기록하고 워크플로우에 전달하십시오. 전체 실행이 자율 모드가 되며 이후 단계에서 다시 묻지 않습니다. 신호가 없으면 워크플로우가 첫 번째 브리프 질문으로 모드를 묻습니다. 기본값은 협력 모드입니다. (/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-videoGitHub 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초 프로모션으로 바꿔 줘", "스크래핑 없는 텍스트 전용 런칭 비디오".

/website-to-video

  • 입력: 목표가 사이트 자체를 보여주는 것인 웹사이트/URL로, 제품을 판매하는 것이 아닙니다. 비상업적 사이트(포트폴리오, 블로그, 문서, 개인, 이벤트) 또는 사용자가 사이트를 있는 그대로 투어하기를 명시적으로 원할 때 가장 좋습니다. 실제 스크린샷과 브랜드 에셋을 위해 헤드리스 Chrome으로 캡처됩니다.

...

관련 스킬