Communitygithub.com

laviedezidane/hyperframes-skill

음악 트랙(오디오 파일, 오디오를 추출할 비디오, 또는 분위기 브리프로 생성된 트랙)을 비트에 동기화된 비디오(가사 비디오, 슬라이드쇼, 혹은 역동적인 프로모션 비디오)로 변환합니다. 음악이 모든 페이싱을 주도하며, 사용자가 제공한 이미지/비디오는 동일한 비트 그리드에 맞춰 편집되며, 완전한 비디오를 만드는 데 자산이 전혀 필요하지 않습니다.

hyperframes-skill란 무엇인가요?

이 스킬은 음악 트랙을 비트에 동기화된 HyperFrames 비디오로 변환하는 종합적인 워크플로우를 제공합니다. 분석부터 렌더링까지 7단계로 구성된 명확한 프로세스를 따르며, 각 단계는 게이트를 통과해야 다음 단계로 진행할 수 있습니다. 핵심 아이디어는 단일 비트 분석기(`analyze-beatgrid.py`)를 신뢰하여 음악의 에너지, 밀도, 롤, 온셋, 무음 구간 등을 분석하고, 각 프레임을 하나의 파일로 만들어 개별 서브 에이전트에게 할당하여 병렬로 제작합니다. 가사 비디오, 슬라이드쇼, 프로모션 비디오 등 다양한 유형을 지원하며, 사용자는 음악 트랙만 제공하면 되고 추가 자산은 선택 사항입니다. 모든 브랜딩(폰트, 색상) 및 템플릿 선택은 3단계에서 이루어지며, 최종 출력은 브라우저에서 미리보기 및 렌더링이 가능한 HTML과 최종 MP4 파일입니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/laviedezidane/hyperframes-skill/tree/HEAD/.agents/skills/music-to-video

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

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

문서

플러그인 설치: 설정 또는 최신화 명령을 실행하기 전에 이 스킬이 HyperFrames 플러그인 내부에 있는 경우 플러그인 설치 규칙을 따르세요. 독립 실행형 설치의 경우 아래 업데이트 지침을 유지합니다.

먼저, 이 스킬을 최신 상태로 유지하세요 — 실행 전에 사용자에게 확인: npx hyperframes skills update music-to-video. 모든 것이 최신 상태이면 빠르게 아무 일도 일어나지 않습니다. 그렇지 않으면 이 스킬과 이 스킬이 의존하는 핵심 도메인 스킬을 사용하기 전에 업데이트합니다.

music-to-video — 음악 기반, 비트 동기화 비디오 워크플로우

이 스킬을 사용하여 음악 트랙을 HyperFrames 비트 동기화 비디오로 변환하세요. 트랙을 한 번 분석하고, 프레임을 배치하고, 프레임별 계획을 작성하고, 각 프레임을 구성 요소로 만듭니다. 입력은 음악 트랙과 선택적으로 사용자의 이미지 또는 비디오입니다 — 내레이션이나 웹사이트 캡처는 없습니다. 타이포그래피와 템플릿이 기본입니다 (완전한 비디오에는 자산이 전혀 필요하지 않습니다); 사용자가 제공한 모든 미디어는 동일한 비트 그리드에 맞춰 편집됩니다.

당신은 오케스트레이터입니다. videos/<project>/ 디렉토리에서 작업합니다. 단계를 순서대로 실행하고 각 게이트를 통과한 후에만 다음 단계로 넘어갑니다. 두 단계에서 사용자와 상호작용합니다: 3단계 (계획 승인) 및 6단계 (렌더링 승인) — 이 두 단계는 ../hyperframes/references/brief-contract.md (0단계 전에 읽어야 함)에 정의된 체크포인트 게이트입니다: 자율 모드에서는 3단계 요약을 사전 알림으로 게시하고 진행합니다. 6단계 렌더링 승인은 유일하게 남은 질문으로 여전히 요청합니다. 4단계를 제외한 모든 단계를 직접 수행하며, 4단계에서는 프레임당 하나의 서브 에이전트를 디스패치합니다. 디자인 및 모션 규칙은 이 파일에 두지 마십시오 — references/와 frame-worker 서브 에이전트에 있습니다.

SKILL_DIR = 이 스킬 디렉토리. PROJECT_DIR = videos/<project-name>/.

워크플로우: 0단계 설정 → hyperframes.json + assets/bgm.mp3; 1단계 분석 → audiomap.json; 2단계 스켈레톤 → STORYBOARD.md (프레임, 그룹 TBD); 3단계 계획 → 완전한 STORYBOARD.md + frame.md; 4단계 제작 → compositions/frames/NN-*.html; 5단계 조립 → index.html; 6단계 렌더링 → renders/video.mp4.

모든 것을 결정짓는 두 가지 아이디어

  • 하나의 분석기, 그리고 그것을 신뢰합니다. analyze-beatgrid.py는 유일한 비트 분석기입니다 — 다른 도구나 귀로 비트를 다시 측정하지 마십시오. 에너지 / 밀도 / 롤 / 온셋 / 무음 값은 항상 신뢰할 수 있습니다. bpm과 beats_sec은 음악이 진정으로 리드미컬할 때만 신뢰할 수 있습니다; 차분한 음악에서는 그리드가 트래커가 부과한 메트로놈이므로, 프레이즈와 에너지로 페이싱하고 절대 그리드에 하드 컷하지 마십시오. 어떤 경우인지 판단하는 것은 각 프레임의 pacing (2단계)입니다.
  • 하나의 프레임 = 하나의 파일; 그룹은 내부에 존재합니다. 2단계는 트랙을 프레임으로 자르고, 각 프레임은 하나의 구성 파일 compositions/frames/NN-<frame_id>.html이 되며, 하나의 frame-worker가 만듭니다. 프레임은 그룹으로 세분화될 수 있습니다 (각 그룹은 템플릿 또는 모션 프리미티브 조합). 추가 밀도는 그룹 _내부_로 들어가므로, 프레임 수는 비트 수가 아니라 별개의 처리를 추적합니다 — 빠른 트랙이 서브 에이전트 수를 늘리지 않습니다.

0단계: 설정, BGM 및 입력

목표: 음악 소스를 설정하고, HyperFrames 프로젝트를 생성하고, 사용자가 제공한 미디어를 기록합니다.

브리프는 의도 레이어에서 시작합니다. 순서대로 열기 규칙: (1) BRIEF.md가 존재함 → 읽고, 답변하는 내용을 묻지 않음 — flow/storyboard가 모드를 파생시킴 (브리프 계약 § 1). (2) BRIEF.md가 없지만 프로젝트가 존재함 → 디스크에 있는 내용에서 재개함; 다시 질문하지 않음. (3) 직접 여기에 도착한 새 생성 요청 → /hyperframes를 읽고 의도 레이어 (references/intent-interview.md)를 실행함: 이 경로의 필수 사항 (음악 소스, 대상 → 종횡비 — ../hyperframes/references/routes/music-to-video.md)을 확인하고 지연될 사항을 알림 — 브랜드와 장르는 설계상 3단계에서 선택됨. 초기화 직후 BRIEF.md를 작성함 (절대 그 전에 작성하지 않음 — init은 비어 있지 않은 디렉토리를 거부함)하고 선호도 기반 답변을 기록함 (brief-format.md). 편집 요청은 이 모든 것을 건너뜁니다.

음악이 중심축입니다 — 다른 모든 것보다 먼저 하나의 트랙을 설정하세요. 이 스킬은 빠르고 고에너지 BGM에 최적화되어 있습니다: 강한 비트 그리드가 컷을 주도합니다 (차분한 트랙도 작동하지만, 비트보다 프레이즈로 페이싱합니다). 사용자가 오디오(음악 파일 또는 오디오를 추출할 비디오)를 제공한 경우 사용하세요. 그렇지 않으면 요청에서 분위기를 선택하고 /media-use (audio/references/bgm.md)를 통해 트랙을 생성합니다. 호스트 앱이 자체 음악 도구를 제공하는 경우 해당 도구를 사용하세요. 첫 번째 인증된 제공자 작업 전에 npx hyperframes auth status를 실행하고 그 출력을 그대로 전달하세요. 로그아웃 상태인 경우 하나의 분기를 적용합니다:

  • 협업: 로그인하거나 로컬 제공자로 오프라인에서 계속하기 위한 명시적 선택을 기다립니다.
  • 자율: 상태를 명시하고 사용 가능한 로컬 제공자를 통해 계속합니다.

오프라인 제공자가 필요한 음악 기능을 충족할 수 없는 경우, 블로커를 표시합니다. 저장소별 .env에 키를 절대 쓰지 마십시오. 인증 소유권 및 오프라인 폴백은 /media-use references/setup-providers.md § 제공자에 있습니다. 결과 트랙은 assets/bgm.mp3에 저장됩니다. 제공된 이미지나 비디오를 스테이징하여 프레임이 비트 그리드에서 사용할 수 있도록 합니다. 그렇지 않으면 타이포그래피가 비디오를 담당합니다.

가사 비디오: 보컬에 동기화된 가사의 경우, /media-use를 통해 트랙을 전사하여 단어/라인 타이밍을 얻거나, 사용자에게 가사 텍스트를 요청하고 비트 그리드에 라인을 배치합니다.

hyperframes.json이 없을 때만 초기화합니다. 브리프에서 kebab-case로 <project> 이름을 지정합니다(예: midnight-drive-loop) — 절대 타임스탬프를 사용하지 마십시오. init은 설치된 스킬을 GitHub의 최신 버전과 비교하고, 오래된 경우 전역 세트를 업데이트합니다.

npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=music-to-video
mkdir -p "$PROJECT_DIR/assets" "$PROJECT_DIR/renders"
cp "<user-music>" "$PROJECT_DIR/assets/bgm.mp3"   # 먼저 비디오에서 추출해야 하는 경우
# 사용자가 이미지/비디오를 제공한 경우에만:
node <SKILL_DIR>/scripts/stage-assets.mjs --from <dir> --hyperframes "$PROJECT_DIR" --into public

브랜드 (폰트 + 팔레트)는 3단계에서 선택되며, 여기서 선택하지 않습니다. 장르나 트랙 유형을 미리 선택하지 마십시오 — 자산은 단지 선택적 재료일 뿐이며, 장르는 프레임별 선택에서 나타납니다.

게이트: hyperframes.json + assets/bgm.mp3가 존재함; 종횡비 / 길이 / fps 및 (있는 경우) 자산 인벤토리가 기록됨.


1단계: 음악 분석

목표: 전체 비디오가 구축되는 하나의 표준 타이밍 분석을 생성합니다.

analyze-beatgrid.py는 유일한 비트 분석기입니다 — 다른 도구나 귀로 비트를 다시 측정하지 마십시오. 트랙을 한 번 읽고 audiomap.json을 작성합니다: 에너지 위상 (레벨 / 밀도 / 느낌), 온셋 + onset_rate, 롤, 무음, hard_stops, key_moments, 프레이즈, 템포 / 그리드 및 audio.duration_sec. 결정론적입니다 — 동일한 파일은 항상 동일한 맵을 제공합니다. 대부분의 필드는 모든 음악에서 신뢰할 수 있습니다. bpm과 beats_sec은 음악이 진정으로 리드미컬할 때만 신뢰할 수 있으며, 이를 판단하는 것은 2단계에서 내리는 결정입니다.

전제 조건: Python 3에 librosa, numpy, soundfile이 설치되어 있어야 합니다. 가져오기에 실패하면 분석기를 실행하기 전에 활성 Python 환경에 설치합니다:

python3 -m pip install librosa numpy soundfile
python3 <SKILL_DIR>/scripts/analyze-beatgrid.py "$PROJECT_DIR/assets/bgm.mp3" \
  -o "$PROJECT_DIR/audiomap.json" --print

게이트: audiomap.json이 존재함; audio.duration_sec이 알려짐.


2단계: 프레임 스켈레톤 (구조만)

목표: 음악을 읽고 프레임을 배치합니다 — STORYBOARD.md의 스켈레톤.

references/frame-skeleton.md를 읽으세요. audiomap.json을 직접 STORYBOARD.md의 스켈레톤으로 변환합니다 — 중간 JSON은 없습니다. 실제 음악 변화(hard_stops, SURGE / DROP key_moments, 롤의 가장자리, 온셋이 없는 구간, 큰 에너지 점프)에서 트랙을 프레임으로 자르고, 모든 경계를 audiomap 앵커에 스냅합니다. 각 프레임에 대해 span_sec, pacing (1단계의 신뢰 판단 결과 — 그리드가 실제일 때 beat_cut, 차분한 음악에 부과된 메트로놈일 때 phrase_flow), mood, 한 줄 feel (3단계에서 템플릿을 매칭하는 일반 음악 상황)을 설정합니다. 여기서는 분류하고 배치만 합니다: 모든 프레임의 ### Groups는 TBD (Step 3)으로 남겨두고 frontmatter style은 비워둡니다 — 템플릿, 복사본, 색상, 폰트는 없습니다. 약 1~6개의 프레임을 예상합니다.

게이트: 프레임이 트랙을 덮음 (첫 번째는 0에서, 마지막은 duration_s에서); 각각 span_sec + pacing + mood + feel을 가지고 있음; 모든 ### Groups는 TBD임; 어디에도 내용이 없음.


3단계: 계획 작성 (사용자 게이트)

목표: 스켈레톤을 승인된 완전한 STORYBOARD.md로 변환합니다.

references/planning.md, storyboard-format.md, template-catalog.md, motion-primitive-catalog.md, 그리고 montage.md (사용자가 자산을 제공한 경우에만)를 읽으세요. 동일한 파일을 제자리에서 편집하면서 두 가지 작업을 수행합니다:

  1. 브랜드를 선택합니다. ../hyperframes-creative/frame-presets/에서 하나의 프리셋을 선택합니다. ../hyperframes-creative/references/design-spec.md의 표를 사용합니다 (트랙의 분위기와 일치시킴; 폰트와 색상만 중요함 — 템플릿이 구성을 소유함). 수정하지 않고 frame.md에 복사하고, frontmatter style을 (해당 프리셋에서 나온 폰트 + 최대 4~6개 스와치 팔레트) 채웁니다.
  2. 모든 프레임을 채웁니다. 그룹을 결정하고 각 그룹에 처리를 부여합니다: 카탈로그의 일치하는 템플릿 (바운드 매개변수 및 실제 audiomap 앵커 포함), 프리미티브 카탈로그의 자유 구성, 또는 pacing을 따르는 자산 처리. 명명된 룩을 자유 구성하기 전에, 라이브 카탈로그에서 검색합니다: 사용자가 요청한 모든 룩, 효과, 처리 또는 전환 — "CRT 스캔라인", "글리치", "필름 그레인", "샤이머 스윕" — npx hyperframes catalog --query "<룩, 일반 영어로>" --json을 실행하고 상위 결과를 읽습니다. template-catalog.md 및 motion-primitive-catalog.md는 이 스킬의 로컬 자료만 나열합니다. 검색은 전체 호스팅 레지스트리 (~400 블록 및 구성 요소)를 순위화하며 설치가 필요하지 않습니다 — 프로젝트, 이전 add, 계정이 없어도 됩니다. 검색 결과에 맞는 것이 없을 때만 룩을 자유 구성합니다. 복사본을 작성합니다. WHAT (템플릿 / 프리미티브 + 내용 + 앵커)은 당신이 소유합니다. frame-worker는 HOW를 소유합니다 — 스토리보드에 밀리초 단위 트윈을 절대 작성하지 마십시오.
node <SKILL_DIR>/scripts/validate-plan.mjs --storyboard "$PROJECT_DIR/STORYBOARD.md" \
  --audiomap "$PROJECT_DIR/audiomap.json" --templates <SKILL_DIR>/references/templates

모든 ✗ (하드 오류: 지속 시간 불일치, 프레임이 트랙을 덮지 않음, 누락된 src)를 수정합니다. 경고는 최선의 노력입니다. 그런 다음 채팅에서 프레임별 요약을 제안으로 제시하고 (../hyperframes/references/review-loop.md § 1), 사용자가 승인할 때까지 사용자의 답변에 따라 반복합니다. storyboard: yes인 경우, 사용자가 열 수 있도록 storyboard.html (../hyperframes-creative/references/storyboard-recipe.md § 3)로도 작성합니다. 자율 모드에서는 이 단계가 체크포인트 게이트입니다: 요약을 사전 알림으로 게시하고 진행합니다 (validate-plan.mjs 통과는 품질 게이트이며 여전히 차단합니다).

게이트: frame.md가 정확한 프리셋 복사본임; validate-plan.mjs가 0으로 종료됨; 사용자가 계획을 승인함 (자율: 요약이 사전 알림으로 게시됨).


4단계: 계획에서 프레임 제작

목표: 모든 프레임을 독립적인 구성 파일로 제작합니다.

compositions/frames/를 생성합니다. sub-agents/frame-worker.md 및 ../hyperframes/references/subagent-dispatch.md를 읽으세요. 프레임당 하나의 frame-worker를 가능한 경우 병렬로 (또는 웨이브로) 디스패치합니다. 각 worker는 정확히 하나의 프레임과 다음 컨텍스트를 받습니다:

PROJECT_DIR: <절대 경로>
frame_id: <NN-frame_id>              # = 프레임 파일 스템, 예: 02-f2; 구성 ID
당신의 블록: PROJECT_DIR/STORYBOARD.md의 `## Frame N — <frame_id>` 블록
audiomap: PROJECT_DIR/audiomap.json
frame.md: PROJECT_DIR/frame.md
재료: 각 그룹에 대해, <SKILL_DIR>/references/templates/<id>/index.html (템플릿) 및
           <SKILL_DIR>/references/motion-primitives/<id>/ (자유); 스테이징된 assets/ (자산 그룹)
계약: ../hyperframes-core/references/sub-compositions.md + determinism-rules.md
캔버스: <w>×<h>   페이싱: <beat_cut|phrase_flow>
쓰기 위치: PROJECT_DIR/compositions/frames/<frame_id>.html

worker는 인용된 재료를 포크하고, 모든 앵커를 프레임 로컬 초로 변환하고 (local_t = track_t − span_sec[0]), 그룹을 0ms 컷으로 게이트하고, 하나의 seek-safe 프레임 파일을 작성합니다. worker는 절대 hyperframes CLI를 실행하지 않습니다 — 해당 명령은 아직 존재하지 않는 조립된 프로젝트에서 작동하므로, 잘못된 파일에 대해 보고합니다. worker는 계약에 따라 작성하고 중지합니다. 조립 후 확인합니다 (6단계). 각 worker가 반환되면 파일이 디스크에 있는지 확인할 수 있습니다.

게이트: 모든 프레임에 대해 compositions/frames/NN-*.html이 디스크에 있음.


5단계: 조립

목표: 제작된 프레임 + BGM을 재생 가능한 index.html로 연결합니다.

assemble-index.mjs는 결정론적입니다 — 서브 에이전트나 판단이 없습니다. 각 프레임 파일을 누적 data-start에 참조하고, assets/bgm.mp3를 트랙 11에 마운트하고, 프레임에서 프레임으로 하드 컷합니다 (프레임이 트랙을 간격 없이 덮으므로, 트랜지션 인젝터가 없습니다).

node <SKILL_DIR>/scripts/assemble-index.mjs --storyboard "$PROJECT_DIR/STORYBOARD.md" \
  --hyperframes "$PROJECT_DIR" --audiomap "$PROJECT_DIR/audiomap.json"

보고된 모든 ✗를 수정합니다 — 누락되거나 빈 프레임 파일은 해당 worker가 부분 파일을 작성했음을 의미합니다. 다시 디스패치 (4단계)하고 다시 조립합니다.

게이트: index.html이 존재함; 총 지속 시간 == audiomap.audio.duration_sec.


6단계: 확인 및 렌더링

목표: 조립된 비디오를 확인하고, 사용자 승인을 받고, 최종 MP4를 렌더링합니다.

조립된 프로젝트에서 CLI를 실행합니다 — 이것이 올바른 유닛입니다. ../hyperframes/references/render-spec.md (§ 2. 확인 및 게이트)를 읽으세요. 프레임 파일이 seek-safe인지 확인합니다 (사용자가 HTML 페이지를 스크러빙할 수 있어야 함). 그런 다음 브라우저에서 미리보기 및 최종 MP4 렌더링을 위해 사용자에게 승인을 요청합니다 (../hyperframes/references/review-loop.md § 2). 자율 모드에서는 단계별 미리보기를 게시하지 않습니다. 이 단계는 체크포인트 게이트입니다: 사용자 승인이 필요합니다.

게이트: renders/video.mp4가 존재함. (가능한 경우) 사용자가 MP4를 열고 승인함.


참조

Individual skills in this repo

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

laviedezidane/hyperframes-skill

Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet `anchor` rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.

laviedezidane/hyperframes-skill

Turn arbitrary text — an article, notes, a topic, a brief — into a faceless explainer video: there is no site or footage to capture, so the visuals are invented per scene (typography, abstract graphics, diagrams, data-viz). Use for topic explainers, concept breakdowns, how-tos, listicles. Not a video built from a website (/product-launch-video — promo or tour). Unclear → /hyperframes.

laviedezidane/hyperframes-skill

Import Figma content into a HyperFrames composition — rendered assets, brand tokens, components, storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI), connector-assisted motion when available, and shaders from a connector or native export. Use when the user pastes a figma.com link or asks to bring a Figma design, frame, logo, brand, or animation into a video/composition.

laviedezidane/hyperframes-skill

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

laviedezidane/hyperframes-skill

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

laviedezidane/hyperframes-skill

Use when audio already placed in a HyperFrames composition needs to be mixed: fade-in/fade-out, crossfade, track gain or volume, volume automation, ducking, a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), automation envelopes drawn on a track's volume or any effect parameter, or one submix bus carrying a chain, a fader and an automation clock for several tracks at once (`<hf-audio-group>`). Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.

laviedezidane/hyperframes-skill

Use the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, cloudrun, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, timeline, history, clean, docs, benchmark, telemetry, transcribe, auth, tts, and remove-background. Also use when diagnosing build or render failures. validate, inspect, and layout are deprecated aliases; use check. Covers local, HeyGen-hosted cloud, AWS Lambda, and Google Cloud Run rendering.

laviedezidane/hyperframes-skill

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

laviedezidane/hyperframes-skill

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

laviedezidane/hyperframes-skill

Use when a HyperFrames composition needs a punch-in, punch-out, zoom, reframe, Ken Burns treatment, camera move, visual match/whip handoff, or other seek-safe 2D/3D keyframes; also for GSAP, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw, text trails, 3D depth, or `hyperframes keyframes` diagnostics. Don't use for broad scene strategy, brand design, media sourcing, captions, or general video planning.

laviedezidane/hyperframes-skill

Search, install, and wire registry blocks and components into HyperFrames compositions. Use BEFORE hand-building any named visual — whenever a brief, a user, or a storyboard names a look, effect, treatment, or transition such as CRT scanlines, glitch, chromatic aberration, film grain, a shimmer sweep, a chart, a code or terminal window, a map, or a confetti burst — because roughly 400 hosted items already cover many of them and the search ranks all of them with nothing installed, no project, and no account. Also use when running hyperframes add or hyperframes catalog, installing one item or every block matching a tag, wiring an installed item into index.html, or working with hyperframes.json. Covers discovery, install locations, block sub-composition wiring, component snippet merging, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

laviedezidane/hyperframes-skill

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.

laviedezidane/hyperframes-skill

Use when working with a person on a HyperFrames project in Studio: first, whether their message asks for a change at all (questions, loose ideas and "don't change anything" get an answer and a plan, not an edit); for a new film, the plan, storyboard and build order that the HyperFrames launch films follow; and how the timeline should be laid out so it reads well (one caption track, one element kind per track, every scene a sub-composition) and where captions and key content may sit (safe zones). Don't use for how to perform an individual edit (split, trim, retime, volume, copy, swap): that is `creator-editing-recipes.md` in `/hyperframes-core`.

laviedezidane/hyperframes-skill

Agent Media OS for a HyperFrames project. Resolve BGM, SFX, image, icon, brand logo, voice, color grade, or LUT into a frozen local file or paste-ready block + ledger record (one verb, `resolve`); generate via TTS / music / image models when the catalog misses; produce voiceover, transcription, captions, and background removal through one shared audio engine; operate on media (cut / reframe / transform); and reuse assets across projects. Also use for vague feedback that real footage looks dark, flat, boring, should feel retro/camcorder/print/ASCII, needs privacy, or needs a media reveal. When the host app provides its own music or sound-effect tools, use those for music and sound effects; `resolve --type bgm|sfx` needs the heygen CLI. When `HEYGEN_API_BASE` is set, HeyGen calls go through that host with no CLI sign-in.

laviedezidane/hyperframes-skill

A short, design-led motion graphic where motion is the message — kinetic typography, stat count-up, chart/data-viz hit, logo sting / brand lockup, lower-third / callout / social overlay, animated map (highlight regions, connect places, zoom to a location), animated tweet / news-article / headline, webpage / UI animation (scroll, cursor, callouts), or fusing a real image's geometry into a chart. Usually under 10s (up to ~30s), no narration or live-action subject; renders to MP4 or transparent overlay. Longer / narrated / multi-scene → /general-video. Unclear → /hyperframes.

laviedezidane/hyperframes-skill

Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.

laviedezidane/hyperframes-skill

Turn a GitHub pull request (a PR URL, owner/repo#N, or 'this PR' in a checked-out repo) into a code-change explainer video — changelog, feature reveal, fix, or refactor walkthrough built from the diff, commits, and files: the input is a code change, not a website. Not a product promo (/product-launch-video) or a no-PR topic explainer (/faceless-explainer). Unclear → /hyperframes.

laviedezidane/hyperframes-skill

Port an existing Remotion (React) composition''s source to HyperFrames HTML. Use ONLY on an explicit ask to port/convert/migrate/translate a Remotion source — one-way, Remotion-only. A passing Remotion mention, reference-only code, or "make something like my Remotion video" is a fresh build (/general-video). Unclear → /hyperframes.

laviedezidane/hyperframes-skill

Author a HyperFrames slideshow — a presentation, pitch deck, or interactive deck with discrete slides, fragment reveals, branching, hotspot navigation, and built-in presenter mode with speaker notes; also converts an existing page into a deck. Output is a navigable deck, not a rendered MP4. If the user didn't explicitly ask for a slideshow, confirm before authoring. Unclear → /hyperframes.

laviedezidane/hyperframes-skill

Package an existing talking-head / interview / podcast video with timed, designed GRAPHIC OVERLAY cards — kinetic titles, lower-thirds, data callouts, quotes, side panels, picture-in-picture — synced to the transcript, on a 16:9 / 9:16 / 4:5 canvas of your choice; the clip plays untouched underneath. Trigger on "graphic overlays", "on-screen graphics", "package / dress up my video". Not plain subtitles (/embedded-captions). Unclear → /hyperframes.

관련 스킬