Communitygithub.com

laviedezidane/hyperframes-skill

기존 단일 인물 토킹헤드 영상에 편집 없이 자막이나 캡션을 추가합니다. 일반 축어 자막, 주제 뒤에 삽입되는 시네마틱 자막, VFX 자막, '炸/特效/酷炫字幕', 또는 35개 스타일 카탈로그의 명명된 아이덴티티에 사용됩니다. 백엔드 엔진이 아닌 시각적 아이덴티티로 경로를 결정합니다. 기본값은 조용한 `anchor` 레일입니다. 사용자가 명시적으로 완전한 시네마틱 처리를 원할 때만 모든 단어를 임베드합니다. 워크플로는 전사 및 피사체 매팅을 포함하여 로컬에서 종단 간 실행됩니다. 적용 전에 여러 샷의 푸티지를 분할하세요.

hyperframes-skill란 무엇인가요?

HyperFrames Embedded Captions 스킬은 단일 인물 토킹헤드 비디오에 원본 푸티지를 편집하지 않고 캡션을 추가하는 로컬 워크플로입니다. 일반 축어 자막(레일)부터 피사체 뒤에 합성되는 시네마틱 임베드, 테마 기반 VFX 자막까지 다양한 스타일을 지원합니다. 사용자는 35개의 사전 정의된 시각적 아이덴티티(CATALOG.md) 중 하나를 선택하며, 백엔드 엔진(Standard, Cinematic, Theme)은 아이덴티티에 따라 자동으로 결정됩니다. 기본 모드는 레일 + 시점별 임베드를 조합하여 불필요한 임베드를 방지합니다. 워크플로는 FFmpeg, Bash, Node.js(Sharp, Puppeteer, GSAP)를 사용하며, 매팅과 전사는 각각 rembg와 Whisper를 사용합니다. 주요 단계는 입력 검증, 아이덴티티 선택, 초기화, 준비(매팅, 전사, 안전 영역), 창의적 JSON 작성, 시각적 미리보기, 렌더링 및 합성입니다.

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

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

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

문서

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

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

임베디드 캡션 (Embedded Captions)

하나의 카탈로그, 미리 선택 (CATALOG.md — 35개의 아이덴티티, 뒤에 있는 엔진은 백엔드 세부 사항입니다). 표준 (기본값)은 깨끗한 축어 레일 (대부분의 텍스트를 담는 하단 1/3 자막) + 임베드 클라이맥스를 피크에서 장면 안 피사체 뒤에 합성합니다. 시네마틱은 순수 임베드입니다 — 레일 없음, 모든 캡션이 피사체 뒤에 합성됩니다 (히어로 타이포그래피, 누적, 가림 효과). 테마는 완전한 테마 구성을 바디 패러다임 × 히어로 세트피스 × 전면 효과 × 플레이트 반응으로 구성하며, 레지스트리에서 가져옵니다 (themes/README.md): ordnance terminal neonsign stardust stomp. 대부분의 설명/음성 해설은 표준입니다; 임베드는 드물고 값진 피크입니다 — 모든 단어를 임베드하는 것은 흔한 실수입니다; 테마는 VFX 급 요청("炸", "特效", "像 AE 做的")을 위한 것입니다.


런타임 전제 조건

플러그인 설치는 매팅, 전사 및 렌더링을 위해 번들로 제공되는 매니페스트 핀 CLI를 사용합니다. 소스 체크아웃이 필요하지 않습니다. 로컬 미리보기 및 캡션 측정 도우미에는 Sharp, Puppeteer (Chromium 브라우저 포함) 및 GSAP도 필요합니다. 읽기 전용 플러그인이 아닌 캡션 프로젝트에 설치하세요:

npm install --prefix <project> --save-dev --save-exact [email protected] [email protected] [email protected]

프로젝트의 잠금 파일을 유지하세요. 이러한 종속성이 이미 존재하는 경우 덮어쓰지 말고 잠긴 버전을 사용하세요. Bash와 FFmpeg/ffprobe가 PATH에 있어야 합니다. 매팅 및 전사는 첫 사용 시 자체 모델을 다운로드할 수 있습니다.

렌더링은 CLI가 성공적으로 종료될 때까지 기다린 후 합성합니다. 이전 HF_TIMEOUT_S 셸 워치독은 더 이상 사용되지 않습니다. 큰 부분 파일은 렌더링이 완료되었음을 증명하지 않습니다. 명시적인 빌드 체크아웃 인수 또는 HYPERFRAMES_ROOT는 플러그인 핀 대신 기여자 CLI를 선택합니다. 중단된 렌더링은 CLI/터미널을 통해 정상적으로 취소하세요; 캡션 도우미는 강제 종료하거나 프로세스 스냅샷에서 렌더링을 복구하지 않습니다.

운영 흐름 (요약)

/hyperframes를 통해 라우팅되며, 의도 레이어는 입력(클립)만 확인하고 아이덴티티 선택은 지연 요청으로 발표합니다 — 후보 목록에는 프로브된 클립이 필요하므로 아래 1단계에 남습니다; 레이어의 실행 형태 질문은 적용되지 않습니다 (푸티지는 그대로이고 검토할 스토리보드가 없습니다). BRIEF.md가 있으면 확인된 입력과 사용자 메모를 전달합니다 — 먼저 읽으세요.

제작 산문은 길지만 파이프라인 자체는 짧습니다 — 그리고 결정적인 모든 것은 계산되거나 컴파일되며 수동으로 작성되지 않습니다:

  1. 결정 게이트 (잘못된 클립 거부) → CATALOG.md에서 하나의 아이덴티티 선택 (35개 아이덴티티; 엔진/컴파일러는 조회로 파생됨 — 모드/카테고리 질문 표시 금지)
  2. hyperframes init (프로젝트 디렉토리가 이미 비디오와 함께 존재하면 건너뜀 — matte.cjs/transcribe.cjs는 디렉토리의 모든 비디오를 source.mp4로 채택) → bash scripts/prepare.sh <프로젝트> (매팅 ∥ 전사 ∥ 오디오 엔벨로프 병렬, 그다음 씬 팔레트/광학/조명을 포함한 safe-zones v2 — 하나의 명령, 잊음 없음)
  3. 작은 JSON 창의적 선택 작성 (먼저 safe-zones.json 읽기): 시네마틱 → cinematic.json → make-cinematic.cjs ( plan.json 파생 및 컴파일); 테마 → theme.json → make-theme.cjs (레일/패널/시/테이크오버 패러다임; anchor는 기본 조용한 레일)
  4. 시각적 QA: node scripts/preview-frames.cjs <프로젝트> → 약 2초/프레임의 신뢰할 수 있는 합성 미리보기 (렌더링 없음). 렌더링 비용을 지불하기 전에 § 시각적 QA를 확인하세요.
  5. render-and-composite.sh → 게이트 (타이밍 / 가림+히어로 / 오버플로 / 핸드오프) → final.mp4

사람들이 놓치는 중요한 규칙:

  • 레일 (기본값) + 임베드 (승격). drop (필러, 표시 안 됨) / rail (축어 하단 1/3 자막, 앞에 위치, 대부분의 텍스트 전달) / embed (피사체 뒤에 합성된 피크 단어). 표준 모드는 둘 다 수행하며, 피크만 임베드합니다. § 캡션 모델 참조.
  • 비디오는 그대로 전달됩니다 (표준/시네마틱; 테마 모드의 PLATE 예산은 유일한 허용 예외 — 테마 DNA별 정의되고 매트 합성 후 적용되는 레지스터 게이트 반응 비트(차지 딤, 펀치, 셰이크, 그레인)로 피사체+텍스트+플레이트가 하나의 프레임으로 움직입니다) — 캡션만 추가됩니다. 매트는 피사체가 임베드 트랙을 가릴 수 있게 합니다. 푸티지를 그레이딩/리컬러/스캔라인하지 마세요.
  • 두 가지 규칙집: 레일 → references/rail.md (얇음), 임베드 제작 → references/composition-craft.md (풍부함, 임베드 전용). 필요에 따라 훑어보세요.

캡션 모델 — 레일 + 임베드

모든 구어 구절은 세 가지 중 하나입니다:

설명표시 방법
drop필러 — 음/어, 말더듬, 자기 수정표시 안 함
rail기본값 — 일반적인 구어 내용 (축어)깨끗한 하단 1/3 자막, 앞에, 읽기 쉽게. 펀치 단어는 인라인 emphasis 하이라이트 (강조 색상 / 활성 단어 팝)를 얻을 수 있습니다 — 레일에 유지됩니다.
embed승격된 피크 — 헤드라인 비트하나의 큰 단어가 피사체 뒤에 합성됩니다 (매트 가림), 설계된 입장 + 퇴장

레일은 대부분의 텍스트를 전달합니다; 임베드는 드물고 값진 피크입니다. 희소성은 클립당이 아니라 비트/블록당: 블록(생각)당 ≤1 히어로, 절대 두 개가 동시에 보이지 않음, 히어로 창 사이에 최소 한 비트의 공기 (컴파일러가 0.6초 미만 경고). 짧은 클립 → 보통 1–2개; 긴 설명 → 섹션당 약 하나. 여러 히어로 중에서, 가장 큰 작성된 히어로가 APEX (전체 잠금 임베드 + 너비 맞춤 상승); 작은 것은 MINOR 피크로 해당 열에서 과장된 강조선 (전경, 감쇠된 움직임)으로 작동합니다 — 모든 비트가 매트 쇼케이스를 필요로 하지 않으며, 이것이 정확히 apex를 이벤트로 유지합니다. 모든 단어를 임베드하는 것은 여전히 흔한 실수입니다.

레일 표면 아이덴티티는 정확히 이것을 구축합니다 (레일 = rail.html, 임베드 = index.html의 클라이맥스). 열 흐름 아이덴티티는 레일을 버리고 모든 것을 임베드 스타일로 만듭니다 — 분위기가 중심이고 축어가 아닌 요청에만 추천하세요. 설명/음성 해설에는 추천하지 마세요 (단어를 읽어야 함) (CATALOG.md는 아이덴티티별로 인코딩).


0단계 — CATALOG에서 하나의 아이덴티티 선택

하나의 프론트엔드, 뒤에 세 개의 엔진. 사용자는 CATALOG.md에서 아이덴티티를 선택합니다 (35개 항목: 10 클래식 + 25 테마); 엔진, 컴파일러 및 작성 파일은 카탈로그 행에서 조회로 파생됩니다. "표준 vs 시네마틱 vs 테마"를 질문으로 표시하지 마세요 — 이들은 백엔드 이름입니다 (제품은 여러 엔진이 있어도 하나의 UX를 가집니다). 카탈로그는 라우팅에 필요한 모든 것을 인코딩합니다: 읽기 표면, 음성, 추천 대상, 씬 필요 사항, 진정으로 가까운 쌍(loud↔ordnance, neon↔neonsign, cream↔stardust)에 대한 인접 메모.

아이덴티티 선택은 선호도 게이트입니다 (../hyperframes/references/brief-contract.md § 1): 자율 모드("놀라게 해줘" / "나 대신 결정해 줘")에서는 직접 후보 목록에서 선택하고 이유를 한 줄로 말하세요.

절차: 클립 프로브 → 카탈로그에서 2–3개 아이덴티티 후보 목록 작성 → 하나의 아이덴티티를 한 줄 이유와 함께 추천 → 사용자가 선택 (자율 모드: 당신이 선택하고 이유를 말함) → 해당 아이덴티티의 파일을 작성합니다. 아이덴티티는 엔진에 잠겨 있습니다 (교차 조합 없음; 하나를 열면 유효성 검사 이벤트입니다 — dna/README.md 참조).

항상 추천을 제시하고 사용자가 작성하기 전에 선택하게 하세요. 조용히 기본값으로 가지 마세요.

(전체 아이덴티티 표는 CATALOG.md에 있습니다 — 라우팅의 단일 진실 공급원. 아래 엔진 문서는 각 백엔드의 작성 계약을 설명합니다.)

CATALOG.md가 여기서 전체 답변 공간입니다: 이 워크플로는 HyperFrames 컴포넌트 레지스트리를 검색하지 않습니다. 구성 워크플로는 명명된 룩을 작성하기 전에 npx hyperframes catalog를 실행합니다. 이것은 그러지 않아야 합니다. 이것의 엔진은 잠긴 컴파일러로, cinematic.json / theme.json을 소비하고 구성을 자체적으로 내보냅니다. 따라서 레지스트리 항목 — 포함된 caption-* 블록 —은 장착할 것이 없습니다. 레지스트리 블록은 설계된 캔버스에 텍스트 스타일을 지정합니다. 이 스킬은 매트를 통해 누군가의 푸티지에 캡션을 굽습니다. 어떤 아이덴티티도 요청에 맞지 않으면, 말하고 가장 가까운 것을 선택하세요. 카탈로그 밖으로 나가지 마세요.

추천 휴리스틱: CATALOG.md의 "Shortlisting heuristics"를 사용하세요 — 이는 아이덴티티 수준입니다 (예: "炸"는 ordnance/stomp/terminal/loud를 후보로 하고 무엇이 폭발해야 하는지에 따라 선택). 범주 수준이 아닙니다. 확실하지 않으면 → anchor.

  • 시네마틱 → 잠긴 템플릿에 대해 cinematic.json을 작성하고 make-cinematic.cjs로 컴파일합니다.
  • 테마 → themes/README.md를 읽고 theme.json을 작성한 후 scripts/render-theme.sh를 실행합니다 (컴파일 + 렌더링 + 플레이트 반응 → final_fx.mp4).

결정 게이트 — 먼저 실행

비디오를 프로브하고 모드 전에 씬을 분류하세요.

ffprobe <video.mp4>                    # 사양
ffmpeg -ss <t> -i <video.mp4> -vframes 1 sample.png   # 20/50/80% 지점

샘플을 읽으세요. 다음 경우 거부:

  • 여러 화자 / 하드 컷 (각 샷을 분할 및 렌더링하거나 거부)
  • 사람 피사체 없음 (이 스킬은 토킹헤드용)
  • 3초 미만, 음성 없음, 또는 얼굴이 명확하게 보이지 않음 — transcribe.cjs는 오디오가 거의 무음일 때 경고합니다 (Whisper는 침묵 위에 "고마워요."와 같은 단어를 환각함); 경고를 따르고 거부하세요. 조작된 단어를 캡션하지 마세요.
  • 소스에 이미 캡션/자막/무거운 텍스트 그래픽이 내장됨 — 두 번째 캡션 시스템을 추가하면 충돌하고 푸티지는 그대로 배송됩니다 (커버/인페인트 없음). 구운 텍스트는 종종 클립 중간에만 나타납니다: 1fps 접촉 시트를 샘플링하세요 (ffmpeg -i in.mp4 -vf "fps=1,scale=160:-1,tile=10x5" sheet.png). 3개의 스팟 프레임을 신뢰하지 마세요.
  • 전사 결과가 쓰레기 — 비원어민/강한 억양의 음성은 자신감 있는 횡설수설로 전사될 수 있습니다. 작성 전에 transcript.json을 이해하면서 읽으세요. 언어로 구문 분석되지 않으면 WHISPER_MODEL=medium을 한 번 시도하고, 그렇지 않으면 거부하세요 (조작된 단어의 축어 레일은 캡션 없는 것보다 나쁩니다).
  • 복잡한 핸드헬드 빠른 움직임 (매트 깜빡임)

사전 점검 프로브 (비용 없음, 최악의 실패 방지)

  1. 샷 컷 프로브. 20%, 50%, 80% 지점에서 프레임 샘플링. 다른 피사체/씬이 나타나면 컷 전에 클립을 자르세요.
  2. 레터박스 / 필러박스 프로브. 첫 번째 프레임에 검은 막대가 있습니까? 안전한 콘텐츠 사각형을 계산하고 캡션 배치를 그 안에 제한하세요.
  3. 휘도 프로브. 캡션 영역의 평균 휘도 샘플링 — 60 미만 → 밝은 텍스트가 그대로 읽힘, 60-180 → 글리프 스크림 추가, 180+ → 불투명 텍스트 + 스크림 (절대 맨 밝은 텍스트 금지). 시네마틱 템플릿은 크림+screen으로 LOCKED — 이 프로브를 사용하여 _적합한 아이덴티티를 선택_하세요 (밝은 씬 → ink 또는 불투명 레일 anchor 테마). 절대 리컬러하지 마세요.
  4. 톤별 아이덴티티 추천 (당신이 추천; 사용자가 선택 — 0단계 + CATALOG.md 참조). 설명 / 인터뷰 / 반드시 읽어야 할 단어 → 레일/패널 표면 아이덴티티; 시적 / 소셜 / "시네마틱" → 등록별 열 흐름 아이덴티티; "炸 / 特效 / VFX" / 명명된 세계 → 테마 아이덴티티. 확실하지 않으면 → anchor (단어 읽힘, 씬 안전) — 하지만 후보 목록을 제시하고 사용자가 선택하게 하세요.

파이프라인 — 5단계

1. hyperframes init <project> --non-interactive --video <video.mp4> --skill=embedded-captions
2. bash scripts/prepare.sh <project>       # 매팅 ∥ 전사 (병렬) → safe-zones. 하나의 명령.
                                           #   → frames_fg/ transcript.json safe-zones.json
3. [에이전트 단계 — 유일한 창의적 단계] 모드에 따라 작은 JSON 작성; 아래 참조
   시네마틱: cinematic.json 작성 → node scripts/make-cinematic.cjs <project>
   테마:     theme.json 작성 → bash scripts/render-theme.sh <project>   (컴파일 + 렌더링 + 플레이트 효과)
4. node scripts/preview-frames.cjs <project>   # ~2초/프레임 합성 미리보기 → § 시각적 QA (렌더링 전)
5. bash scripts/render-and-composite.sh <project>  # 게이트 → final.mp4 + history/ 스냅샷
   (테마 모드: 3b/5단계 건너뛰기 — render-theme.sh가 이미 compile + render-and-composite
    + _postfx.sh를 실행합니다. 결과물은 final_fx.mp4이며, final.mp4는 플레이트 반응 전입니다)

1단계의 init는 설치된 스킬을 GitHub의 최신 버전과 확인하고 오래된 것이 있으면 글로벌 세트를 업데이트합니다.

3단계는 모드에 따라 다릅니다:

3단계 — 시네마틱 모드 (순수 임베드)

  1. 먼저 safe-zones.json을 읽으세요. 내레이션 평면은 zones.hugLeft/hugRight 에 배치됩니다 — 실루엣에 인접한 깨끗한 스트립 (몸에서 먼 텍스트는 떠 있는 것처럼 읽히며 내장되지 않음; 먼 모서리는 기본값이 아닌 대체입니다). 히어로는 기본적으로 heroAnchor/heroBands.best (피사체 중앙에 위치, 약 30–55% 가려짐)입니다. recommendation:"fg"는 가독성을 위해 내레이션을 앞으로 이동합니다; heroBands.feasible일 때 히어로는 내장된 상태를 유지합니다 — 히어로 전경은 최후의 수단입니다.
  2. **DNA는 0단계에서 선택한 아이덴티티입니다.

…

[번역을 위해 잘림]

Individual skills in this repo

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

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 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.

관련 스킬