Communitygithub.com

laviedezidane/hyperframes-skill

일반 텍스트(기사, 노트, 주제, 요약)를 무언의 설명 동영상으로 변환합니다. 사이트나 실제 영상을 캡처하지 않고, 장면마다 시각 자료(타이포그래피, 추상 그래픽, 다이어그램, 데이터 시각화)를 창작합니다.

hyperframes-skill란 무엇인가요?

이 스킬은 주어진 텍스트를 '얼굴 없는(faceless)' 설명 동영상으로 제작하는 HyperFrames 오케스트레이터입니다. 사용자가 기사나 노트 등 순수 텍스트만 제공하면, 캡처 단계 없이 장면별로 시각 자료를 창작하여 교육용, 개념 설명, 사용 방법, 리스트 영상을 만듭니다. 이 스킬은 HyperFrames 플러그인으로 동작하며, 단계별 게이트 방식을 통해 진행 상황을 확인하고, 디자인 시스템 선택, 스토리보드 및 스크립트 작성, 오디오 생성, 프레임 구성, 최종 렌더링을 자동화합니다. 모든 시각 요소는 사전 정의된 프레임 프리셋과 창의적인 규칙에 따라 만들어지므로, 사용자는 원본 텍스트와 원하는 분위기만 지정하면 됩니다. 주로 Cursor, Claude Code, Codex 같은 AI 에이전트와 함께 사용되며, 동영상 제작 워크플로우를 완전히 대행합니다.

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

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

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

문서

플러그인 설치: 설정 또는 freshness 명령 전에, 이 스킬이 HyperFrames 플러그인 내부에 있을 경우 플러그인 실행 규칙을 따릅니다. 독립 설치 시 아래 업데이트 지침을 유지합니다.

먼저, 이 스킬을 최신 상태로 유지하세요 — 사용자 확인 후 실행: npx hyperframes skills update faceless-explainer. 모든 것이 최신 상태면 빠른 no-op; 그렇지 않으면 이 스킬과 그것이 의존하는 핵심 도메인 스킬을 새로 고친 후에 의존합니다.

media-use: 오디오/이미지/로고를 소싱하기 전에 /media-use를 호출하여 HeyGen 카탈로그의 BGM/SFX/이미지와 공식 소스의 브랜드 로고를 확인합니다. 기존 에셋을 등록하려면 --adopt를 먼저 실행합니다. /media-use 스킬을 참조하세요. 호스트 앱이 자체 음악 또는 음향 효과 도구를 제공하는 경우 음악과 음향 효과에 해당 도구를 사용합니다.

얼굴 없는 설명 동영상 → HyperFrames

이 스킬을 사용하여 텍스트 본문을 설명 동영상으로 변환합니다: 디자인 시스템을 선택하고, 교육적 스토리를 계획하고, HyperFrames에서 프레임별로 구축합니다. 얼굴 없음은 모든 시각 자료가 다운스트림에서 창작된다는 뜻입니다 — 캡처 단계가 없고 실제 에셋 인벤토리도 없습니다.

정문은 /hyperframes입니다. 당신은 오케스트레이터입니다. 각 단계를 실행하고, 게이트를 확인한 후에만 계속 진행하세요. 이 스킬은 제품이나 캡처할 웹사이트 없이 텍스트로 주제를 설명하는 용도입니다. 다른 의도, 그냥 "동영상 만들어" 또는 불확실한 경우 → 먼저 /hyperframes를 읽으세요 — 의도 레이어가 모든 경로 결정을 소유하며, BRIEF.md 없이 여기에 도착한 새 생성은 어차피 그 레이어를 거칩니다(설정의 시작 규칙).

당신은 오케스트레이터입니다. videos/<project>/ 디렉토리에서 작업합니다. 단계를 순서대로 실행하고 각 게이트를 통과한 후에 계속 진행하세요. 사용자 게이트 단계는 Step 0, Step 3, Step 6입니다. Step 0 전에 ../hyperframes/references/brief-contract.md를 읽으세요 — 게이트 유형과 BRIEF.md의 flow/storyboard가 Step 3/4/6 게이트를 제어하는 모드를 어떻게 도출하는지 정의합니다. Step 5를 제외한 모든 단계를 직접 수행하세요. Step 5에서는 프레임당 하나의 서브 에이전트를 파견합니다. 디자인 또는 모션 규칙을 여기에 두지 마세요. 그것들은 프레임 워커 서브 에이전트, 이 스킬의 로컬 ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/, 그리고 hyperframes-creative에 있습니다.

워크플로우: Step 0 설정 → hyperframes.json; Step 1 브리프 → capture/extracted/; Step 2 디자인 시스템 → frame.md; Step 3 스토리보드/스크립트 → STORYBOARD.md 및 SCRIPT.md; Step 3.1 오디오 → audio_meta.json; Step 4 시각 디자인 → 보강된 STORYBOARD.md; Step 5 프레임 → compositions/frames/NN-*.html 및 index.html; Step 6 최종 렌더링 → renders/video.mp4.


Step 0: 설정

목표: 확인된 브리프를 가지고 시작하여 HyperFrames 프로젝트를 생성하고 브리프를 지속 가능하게 만듭니다.

브리프는 여기서 질문하는 것이 아니라 의도 레이어에 의해 확인됩니다. 시작 규칙, 순서대로: (1) BRIEF.md가 존재 → 읽고 아무것도 묻지 않음 — 브리프는 확정되었으며, flow/storyboard가 모드를 도출합니다(브리프 계약 § 1). (2) BRIEF.md는 없지만 프로젝트가 존재(hyperframes.json / STORYBOARD.md가 디스크에 있음) → 스토리보드의 frontmatter와 기록된 환경설정에서 재개합니다. 절반만 구축된 프로젝트에 다시 질문하지 마십시오. (3) 둘 다 없음 — 여기에 직접 도착한 새 생성 요청 → /hyperframes를 읽고 의도 레이어(references/intent-interview.md)를 실행합니다. 레시피와 기억된 기본값을 확인하고, 이 경로의 질문(../hyperframes/references/routes/faceless-explainer.md)을 수행하고, 잠긴 브리프를 반환합니다. 편집 요청은 이 모든 것을 건너뜁니다 — 편집을 수행하세요.

hyperframes.json이 없을 때만 초기화합니다. <project> 이름은 주제에서 케밥-케이스로 지정합니다(예: compound-interest-explained). 워크스페이스 이름이나 타임스탬프를 사용하지 마십시오.

npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=faceless-explainer — init은 설치된 스킬을 GitHub의 최신 버전과 비교하고 오래된 경우 글로벌 세트를 업데이트합니다.

init 후, <PROJECT_ROOT>를 videos/<project>로 하고 모든 후속 상대 경로 명령을 해당 디렉토리를 작업 디렉토리로 하여 실행합니다. 아래 명령에서 .는 <PROJECT_ROOT>를 의미합니다. 호출자 디렉토리에 .media, capture 또는 출력 파일을 절대 쓰지 마십시오.

init 직후 BRIEF.md를 작성하십시오 (절대 그 전에 — init은 비어 있지 않은 디렉토리를 거부합니다): 의도 레이어의 잠긴 브리프, ../hyperframes/references/brief-format.md의 형식. <MEDIA_DIR>을 설치된 /media-use 스킬 디렉토리로 확인합니다. 그런 다음 각 환경설정 기반 답변을 node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes .로 기록합니다(brief-format.md가 하위 집합을 명명합니다). 의도 레이어가 레시피를 채택한 경우 node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes . --name <name>을 실행합니다. 프로젝트에 frame.md를 복사하고(Step 2는 건너뜀) Step 3 초안이 작성할 뼈대를 반환합니다. 레시피는 답변을 채우고 승인은 채우지 않습니다. 검토 게이트는 여전히 실행됩니다.

Setup을 넘어가기 전에 로그인 상태를 표시하십시오 — npx hyperframes auth status를 실행하고 출력을 그대로 전달합니다. 음성/BGM이 HeyGen을 사용할지 로컬 엔진을 사용할지, 그리고 로그아웃된 경우 로그인 방법을 보고합니다. 한 가지 분기를 적용합니다:

  • 협력: 사용자가 로그인하거나 명시적으로 offline / go를 선택할 때까지 기다립니다.
  • 자율: 상태를 알리고 사용 가능한 로컬 엔진을 통해 계속 진행합니다.

오프라인 공급자가 없을 때 필요한 기능을 조용히 생략하지 마십시오. 장애물을 표면에 드러내십시오. 이 결정을 다른 질문에 포함시키거나 per-repo .env에 키를 작성하지 마십시오. 인증 소유권 및 오프라인 대체: /media-use references/setup-providers.md § 공급자.

게이트: hyperframes.json 및 BRIEF.md가 존재합니다; 환경설정 기반 답변이 기록되었습니다(브리프 계약 § 2); 로그인 상태가 표시되었습니다(로그인됨 또는 오프라인 계속 진행).


Step 1: 브리프 (캡처 없음)

목표: 사용자의 텍스트를 정보 소스로 프로젝트에 통합합니다. 웹사이트 캡처도 실제 에셋도 없습니다 — 이것은 얼굴 없는 설명 동영상입니다.

사용자의 전체 입력을 그대로 저장한 다음 수동으로 합성 캡처 패키지를 생성합니다:

  • capture/extracted/visible-text.txt — 전체 기사 / 노트 / 주제 / 요약, 그대로. 이것은 정보의 소스이며 스토리 템플릿이 아닙니다(Step 3에서 재구성됨).
  • capture/extracted/tokens.json — { "title": "", "description": "", "colors": [], "fonts": [] }. 브리프에서 title/description을 채웁니다. 사용자가 명시적으로 브랜드 색상이나 글꼴을 제공하지 않는 한 colors/fonts를 비워 둡니다 — 제공한 경우 추가합니다(디자인 프리셋이 어쨌든 완전한 팔레트를 제공합니다).

사용자가 스크립트를 붙여넣거나 자신의 문구를 유지하기를 원하는 경우 user_script.txt로 그대로 저장합니다. VO_MODE(그대로 또는 재구성)는 BRIEF.md에서 가져옵니다 — 의도 레이어는 스크립트가 도착할 때 묻습니다. 브리프에 어떻게든 누락된 경우에만 여기서 한 번 묻고 Step 3을 위해 답변을 저장합니다.

npx hyperframes capture를 실행하지 마십시오 (URL이 없습니다). asset-descriptions.md를 생성하거나 capture/assets/를 채우지 마십시오 — 얼굴 없는 시각 자료는 Step 4-5에서 창작되며 캡처되지 않습니다. 한 가지 예외: 사용자가 실제 이미지를 제공한 경우 public/<basename> 아래에 배치하고 Step 3을 위해 기록해 둡니다.

게이트: capture/extracted/visible-text.txt와 capture/extracted/tokens.json이 존재합니다. 설명 동영상의 주제와 대상 청중을 명확한 한 문장으로 말할 수 있습니다.


Step 2: 디자인 시스템

목표: 제공된 프레임 프리셋 중 하나를 선택합니다. 스크립트가 이 동영상의 frame.md + 캡션 스킨으로 변환합니다.

BRIEF.md가 style_preset을 명명한 경우 — 사용자가 의도 레이어에서 쇼케이스를 보고 선택했습니다 — 그것을 사용합니다. 판단은 브리프가 침묵할 때만 여러분이 내립니다. 그런 다음 한 가지 호출을 합니다 — 어떤 프리셋: ../hyperframes-creative/references/design-spec.md를 읽고 ../hyperframes-creative/frame-presets/를 탐색합니다. 주제, 톤, 대상 청중에 가장 잘 맞는 프리셋을 선택합니다. 그런 다음 실행합니다:

node <SKILL_DIR>/scripts/build-frame.mjs --preset <name> --hyperframes .

스크립트는 나머지를 결정론적으로 수행합니다: 프리셋의 FRAME.md를 frame.md로 복사하고 capture/extracted/tokens.json의 브랜드 토큰에 리믹스합니다 (브랜드 색상이 역할별로 프리셋의 색상 키에 매핑됨; 프리셋의 디스플레이 + 본문 글꼴이 브랜드의 것으로 교체됨), 프리셋의 캡션 스킨을 .hyperframes/caption-skin.html로 복사하고, 자체 검증합니다(깨진 매핑 시 exit 1). exit 0이 되는 즉시 진행합니다 — 사양을 수동 편집하지 마십시오.

얼굴 없는 설명 동영상은 일반적으로 브랜드 색상/글꼴이 없습니다 (tokens.json colors/fonts가 비어 있음) → 스크립트는 프리셋 자체의 팔레트, 즉 완전히 출시 가능한 디자인을 유지합니다. 사용자가 브랜드 색상/글꼴을 지정한 경우에만 실행 전에 tokens.json에 추가하고, 매핑이 정말로 필요한 경우에만 frame.md를 수동으로 조정합니다.

게이트: build-frame.mjs가 exit 0으로 종료되었습니다 — frame.md가 명명된 프리셋에서 존재하고, (프리셋이 제공하는 경우) .hyperframes/caption-skin.html이 캡션 스킨 소스로 존재합니다. 선택한 프리셋이 환경설정으로 기록되었습니다(--key style_preset --workflow <this workflow>, 브리프 계약 § 2).


Step 3: 스토리보드 및 스크립트

목표: 텍스트를 승인된 프레임별 교육 계획으로 변환합니다.

../hyperframes-creative/references/story-spine.md (후크 언어, 증거 전 가치, 제안으로서의 스토리보드, 소스 추적 가능한 시각 자료), references/story-design.md, ../hyperframes-animation/blueprints-index.md, ../hyperframes/references/storyboard-format.md, ../hyperframes/references/script-format.md를 읽으십시오. 이를 사용하여 STORYBOARD.md와, 내레이션이 필요할 때 SCRIPT.md를 작성합니다. 브리프의 length에서 frontmatter duration:을 설정합니다 — 대략적인 예상입니다. 조립 시 최종 컷이 이에 비해 어디에 있는지 보고합니다.

설명 동영상 구조(개념 / 사용 방법 / 리스트 / 이야기), 후크 전략, 명확성 기법, 감정적 비트, 유형-열거형 매핑 및 VO_MODE에 대해 story-design.md를 사용하십시오. 동영상 시퀀스는 내러티브 디자인에서 나오며, 입력 텍스트의 단락 순서가 아닙니다 — 재정렬, 병합, 생략, 압축합니다. 소프트 가이드로, ../hyperframes-animation/blueprints-index.md의 역할→청사진 메뉴를 참조하십시오: 각 비트에 대해 후보 청사진이 암시하는 형태로 음성 해설을 작성하고, 맞는 경우 해당 후보 blueprint: id를 태그하십시오. 교육적 진실은 여전히 어떤 비트가 존재하는지를 결정합니다 — 절대 비트를 청사진에 맞추기 위해 강제하지 말고, 입증된 형태가 있다고 해서 비트를 발명하지 마십시오. 얼굴 없는 시각 자료는 다운스트림에서 창작되므로 프레임은 에셋 인벤토리를 포함하지 않습니다: 사용자가 실제 public/<basename> 이미지를 제공하지 않는 한 asset_candidates를 비워 둡니다. 스토리보드 및 스크립트 참조의 정확한 필수 필드를 사용하십시오.

초안 작성 후, 검토 루프의 계획 단계를 실행합니다 — ../hyperframes/references/review-loop.md § 1: 계획을 제안으로 제시하고 두 가지 질문을 합니다 — 승인 또는 변경, 그리고 스케치 먼저(권장) 또는 건너뛰기. 피드백은 채팅 답변으로 도착합니다. 승인될 때까지 반복합니다. 이것은 체크포인트 게이트입니다(브리프 계약 § 1): 자율 모드에서는 물을 것이 없습니다 — 동일한 요약을 헤드업으로 게시하고 진행합니다. 스케치는 빌드에 통합되고, 하나의 질문이 있는 최종 미리보기는 Step 6에서 옵니다.

게이트: STORYBOARD.md가 존재하고, 모든 프레임에 필수 내러티브 필드가 있으며, 내레이션이 필요할 때 SCRIPT.md가 존재하고, 사용자가 프레임별 계획을 승인했습니다(자율: 요약이 헤드업으로 게시됨).


Step 3.1: 오디오

목표: 승인된 스크립트에서 내레이션, 단어 타이밍, 음악 및 오디오 메타데이터를 생성합니다.

Step 3 승인 후 오디오를 시작합니다. 백그라운드에서 실행한 다음 Step 4로 계속 진행합니다. (로그인 상태는 이미 Step 0에서 표시되었습니다. 엔진은 자동으로 대체됩니다.)

호출하기 전에 사용자의 요청에서 내레이션 음성을 선택합니다. 요청에서 음성, 성별 또는 톤을 지정한 경우 일치하는 음성 ID를 선택하고 --voice <id>로 전달합니다. 파이프라인 기본값은 그렇지 않으면 Marcia (여성) (HeyGen) / am_michael (Kokoro)입니다 — 따라서 "남성 음성"과 같은 요청은 플래그를 전달하지 않으면 자동으로 무시됩니다. 음성 ID는 공급자별로 다릅니다. Step 0의 로그인 상태가 선택한 공급자에 따라 확인합니다: HeyGen (로그인됨)은 node <MEDIA_DIR>/audio/scripts/heygen-tts.mjs --list를 통해(또는 GET /v3/voices?engine=starfish); Kokoro (오프라인)는 <MEDIA_DIR>/audio/references/tts.md의 음성 테이블을 통해(am_/bm_ 남성, af_/bf_ 여성 접두사). 사용자가 선호도를 표현하지 않은 경우, 파이프라인 기본값보다 먼저 기억된 음성(브리프 계약 § 2)으로 대체하고, 사용한 음성을 말합니다. 둘 다 이름을 지정하지 않은 경우에만 --voice를 생략합니다. 사용자가 이 실행에서 음성을 명시적으로 선택한 경우 기록합니다(prefs.mjs record --key voice).

node <SKILL_DIR>/scripts/audio.mjs --script ./SCRIPT.md --storyboard ./STORYBOARD.md --hyperframes . --out ./audio_meta.json --voice <voice-id> &

오디오 스크립트는 내레이션, 단어 타이밍, HeyGen 음악 라이브러리에서 BGM 조회 및 타이밍 메타데이터를 처리합니다. BGM 분위기는 스토리보드의 music: 필드에서 가져옵니다. 이것은 생성이 아닌 검색을 위해 HeyGen 오디오 API를 사용하며, TTS와 동일한 ~/.heygen 자격 증명을 사용합니다. 공급자 세부 정보는 ../media-use/audio/references/tts.md를 읽으십시오. 호스트 앱의 자체 도구가 음악 또는 사운드 효과를 만드는 경우, 파일을 assets/ 아래에 두고 "source": "host"로 표시된 audio_meta.json 파일에 나열합니다. 음악은 bgm { "path": "assets/…", "source": "host" }로 스토리보드에 music: none과 함께; 사운드는 sfx 항목 { "frame": <n>, "file": "assets/…", "offset_s": 0, "duration_s": <길이>, "source": "host" }로. 모든 오디오 패스는 이것들을 유지하며, 호스트 사운드가 있는 프레임은 조회된 큐가 없습니다.

내레이션도 없고 SCRIPT.md도 없으면 음성 생성을 건너뜁니다. 스토리보드에 음악 분위기가 있으면 BGM이 여전히 실행될 수 있습니다.

정식 완전 무음 마커 (이 오디오 모델을 재사용하는 워크플로우 전체에서 공유됨): STORYBOARD.md 상단 YAML 블록에 music: none, SCRIPT.md 없음, 그리고 sfx: 큐나 호스트 오디오 없음. 그 조합은 프로젝트를 무음으로 표시합니다 — 내레이션, BGM, 사운드 효과 없음. 그러면 오디오 생성을 완전히 건너뜁니다. audio_meta.json 파일을 만들지 마십시오. 무음 프로젝트는 audio_meta.json이 있어서는 안 됩니다.


Step 4: 시각 디자인

목표: 스토리보드 비트에 대한 시각 자료를 설계합니다. 각 프레임의 visual_design 필드를 작성하고 모션을 고려하여 장면 전환을 미리 봅니다.

각 스토리보드 프레임을 보강합니다. 사용자가 Step 3에서 스케치를 요청한 경우 먼저 프레임을 생성합니다(Step 5 명령 사용). 보강 단계는 스토리보드 구조를 유지하면서 각 프레임에 visual_design 필드를 추가합니다:

  • framing: 프레임 레이아웃(단일 화면, 분할 화면, 전체 화면 다이어그램, 사이드바, 작은 인용문). frame.md의 레이아웃 변형 중에서 선택하십시오.
  • graphics: 사용할 차트/다이어그램 유형 (막대 차트, 흐름도, 타임라인, 벤 다이어그램, 레이블이 있는 그림). 동일한 스토리보드 단계 동안에만.
  • animation: 장면 진입 방법(페이드 인, 왼쪽에서 슬라이드, 확대/축소 강조, 형태 변화). 전체 세부 사항은 ../hyperframes-animation/rules/를 참조하십시오.
  • captions: 각 프레임에 대한 캡션 텍스트 (있는 경우, 키워드 또는 전체 문장). 캡션은 frame.md 캡션 시스템을 통해 렌더링됩니다; 여기서 내용을 지정하십시오.
  • transition: 이 프레임에서 다음 프레임으로의 전환 (컷, 페이드, 슬라이드, 매직 무브)과 전환 시간(초).

../hyperframes-animation/blueprints/의 청사진을 참조하여 일반적인 시각적 접근 방식을 확인하십시오. 얼굴 없는 설명 동영상은 스톡 사진/비디오를 사용하지 않습니다 — 여기에 나열된 모든 그래픽은 다운스트림에서 생성됩니다.

게이트: STORYBOARD.md가 업데이트되었으며, 각 프레임에 채워진 visual_design 필드가 있습니다.


Step 5: 프레임

목표: 각 프레임에 대해 하나의 서브 에이전트를 파견하여 모든 프레임을 병렬로 작성하고, 완료되면 조합합니다.

Step 5를 프레임당 단일 서브 에이전트로 분할합니다. 각 서브 에이전트에 대해:

  1. compositions/frames/ 디렉토리를 생성합니다.
  2. 서브 에이전트당 하나의 프레임을 할당합니다. 각 서브 에이전트는 다음을 읽습니다:
    • 화면 디자인에 대한 frame.md
    • 모션 및 타이밍에 대한 ../hyperframes-animation/rules/
    • 레이아웃 청사진에 대한 ../hyperframes-animation/blueprints/
    • 프레임의 스토리보드 항목(비주얼 디자인 보강 포함)
    • 해당 프레임에 대한 오디오 큐(있는 경우)를 포함한 audio_meta.json
  3. 각 서브 에이전트는 다음을 작성합니다:
    • compositions/frames/NN-index.html (여기서 NN은 00, 01, 02 등) — 완전한 자체 포함 HTML 파일, CSS 및 JavaScript 인라인
    • 애니메이션을 위한 CSS
    • 타이밍 및 대화형을 위한 JavaScript
  4. 각 HTML 파일은 다른 모든 파일과 독립적으로 렌더링되어야 합니다. 필요에 따라 공유 CSS/JS 라이브러리를 포함할 수 있지만 파일 간 충돌을 피하십시오.
  5. 모든 프레임이 완료되면 compositions/frames/index.html을 작성합니다. 이 프레임 갤러리 페이지는 iframe을 사용하거나 썸네일 그리드로 모든 프레임을 표시합니다.

프레임 작성에 대한 자세한 내용은 ../hyperframes-animation/references/frame-worker-guide.md에서 확인하세요.

게이트: compositions/frames/ 디렉토리는 모든 프레임에 대한 HTML 파일과 compositions/frames/index.html을 포함합니다.


Step 6: 최종 렌더링

목표: 모든 프레임을 최종 동영상 파일로 조합합니다.

npx hyperframes render ./compositions/frames/ --out ./renders/video.mp4 --audio ./audio_meta.json

렌더링이 완료되면 완성된 파일을 표시하고 최종 승인을 위해 사용자에게 미리보기를 보여줍니다. 이것은 최종 게이트입니다(브리프 계약 § 1): 사용자에게 동영상을 보여주고 "승인하거나 변경하시겠습니까?"라고 묻습니다. 수정이 필요한 경우 요청된 변경 사항을 적용하고 다시 렌더링합니다. 변경이 더 이상 없으면 동영상이 완료된 것입니다.

게이트: renders/video.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

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 music track (an audio file, a video to pull audio from, or a track generated from a mood brief) into a beat-synced video — lyric video, slideshow, or kinetic promo. The music drives all pacing; any user-supplied images/videos are cut onto the same beat grid, and a complete video needs zero assets. Narrated pieces → the input-matched workflow (see /hyperframes). 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.

관련 스킬