Communitygithub.com

sherlock-126/video_ai

HyperFrames의 시작 기술입니다. 비디오, 애니메이션, 모션 그래픽, 설명 영상, 제목 카드, 자막 영상, 제품 프로모션 등 모든 영상 제작 요청을 시작하기 전에 반드시 읽어야 합니다.

video_ai란 무엇인가요?

이 기술은 HyperFrames 시스템의 진입점이자 전체 역량 지도 역할을 합니다. 사용자가 "비디오를 만들어 줘"라는 의도를 표현하면, 해당 의도에 맞는 최적의 워크플로우(예: 제품 출시 비디오, 무면 설명 영상, 웹사이트-비디오, PR-비디오, 자막 삽입, 그래픽 오버레이, 모션 그래픽, 일반 비디오, Remotion-to-HyperFrames 등)로 라우팅하는 의사 결정 테이블을 제공합니다. 이 기술은 주로 Claude Code, Cursor, Codex 등 AI 코딩 에이전트에서 사용되며, HyperFrames 코어, 애니메이션, 크리에이티브 방향, 미디어 전처리, CLI 개발 루프, 레지스트리 등 하위 도메인 기술을 조정합니다. 또한 HyperFrames가 할 수 없는 작업(예: 비디오 편집, 실시간 데이터 가져오기, 화면 녹화)을 명확히 정의하여, 범위를 벗어난 요청을 적절히 거절하거나 다른 도구로 안내합니다.

지원 대상✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/sherlock-126/video_ai/tree/HEAD/skills/hyperframes

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

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

문서

HyperFrames — 먼저 읽으세요

모든 HyperFrames 작업은 여기서 시작 — 특히 프로젝트 에이전트 설정 파일(CLAUDE.md / AGENTS.md / .cursorrules)이 없을 때. 역량 지도 + 비디오 라우터는 아래를 참조하세요.

역량 지도 — 어떤 의도에 어떤 기술

원하는 작업이동할 위치
비디오 만들기 (URL, 브리프, 주제, GitHub PR, 기존 영상, 또는 애니메이션할 단일 요소)아래 비디오 라우터 (§ 비디오 라우팅)
HTML 컴포지션 작성/편집 — data-* 계약, 클립, 트랙, 서브 컴포지션, 변수/hyperframes-core
애니메이션 — 원자적 모션 규칙, 씬 청사진, 전환, 런타임 어댑터 (GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU)/hyperframes-animation
크리에이티브 방향 — design.md, 팔레트, 타이포그래피, 내레이션, 비트 계획, 오디오 반응/hyperframes-creative
미디어 전처리 — TTS 음성 해설, 배경 음악, 전사, 배경 제거, 자막/hyperframes-media
CLI 개발 루프 — init, lint, validate, inspect, preview, render, publish, doctor/hyperframes-cli
레지스트리 블록/컴포넌트 설치 (hyperframes add)/hyperframes-registry

컴포지션 작성 계약 (모든 시간 요소에는 data-start / data-duration / data-track-index 필요, 시간 요소는 class="clip" 사용, GSAP 타임라인은 일시 중지되고 window.__timelines에 등록, 결정론적 로직만 — Date.now() / Math.random() / 네트워크 금지)은 여기에 중복되지 않습니다 — /hyperframes-core에 있습니다. 컴포지션 HTML을 작성하기 전에 먼저 읽으세요.

HyperFrames가 할 수 없는 것 — 먼저 확인

HyperFrames는 HTML 컴포지션을 작성하고 코드에서 MP4로 렌더링합니다. 이 모델에는 명확한 외부 경계가 있습니다. 다음 요청 중 하나가 들어오면 라우팅 선택이 아니라 범위 밖이므로, 워크플로우를 찾는 대신 거절하거나(또는 올바른 도구를 가리키세요). 이는 특정 요청이 아닌 아키텍처에서 비롯됩니다:

  • 렌더링은 결정론적이고 자체 포함됩니다. 작성 시 모든 값, 자산, 텍스트가 고정됩니다. 렌더링은 네트워크 호출이나 실시간/렌더링 시 데이터 풀을 수행하지 않습니다(핵심 규칙: Date.now() / Math.random() / 네트워크 금지). "렌더링 시 실시간으로 숫자 새로고침"은 불가능합니다 — 작성 시 데이터를 한 번 가져와 고정하거나 거절하세요.
  • 기존 비디오는 오버레이만 가능, 편집 불가. HyperFrames는 소스 클립 위에 프레임을 구성합니다 — /embedded-captions는 자막 레이어 추가, /graphic-overlays는 디자인된 그래픽 카드(하단 3분할, 데이터 콜아웃, 타이틀) 추가 — 클립은 그대로 재생됩니다. 인코딩된 비디오 스트림을 후처리하지 않습니다. 영상 자체(타이밍, 색상, 프레이밍, 순서, 오디오)를 변경하는 것은 NLE 스타일 편집으로 범위 밖입니다.
  • Remotion 가져오기는 단방향입니다. /remotion-to-hyperframes는 Remotion 프레임워크의 소스를 HyperFrames로 번역합니다. 역방향(HyperFrames → Remotion, 또는 다른 프레임워크)은 없습니다. 비-Remotion React/웹 애니메이션 소스에는 번역할 Remotion 소스가 없습니다 — /general-video를 통해 다시 생성하세요.
  • 가지고 있지 않은 입력은 생성할 수 없습니다. 화면/세션 녹화, 카메라 캡처, AI 토킹헤드/립싱크 아바타 생성 불가. 영상이나 자산이 아직 존재하지 않으면 HyperFrames가 conjure할 수 없습니다 — 사용자에게 제공하거나(또는 올바른 캡처 도구 사용) 요청하세요.

나머지 모든 것 — URL, 브리프, 주제, PR, 주석 달 영상, 또는 애니메이션할 단일 요소에서 비디오 — 는 범위 내에 있습니다. 아래에서 라우팅하세요.


비디오 라우팅

이 섹션은 최상위 워크플로우만 알고 있습니다. 워크플로우 내부 단계, 도메인 기술(hyperframes-* — 위 역량 지도 참조), 또는 기술 참조를 로드하지 않습니다.

결정 테이블

입력 유형(의도)이 기본 축입니다. 출력 길이는 상한선일 뿐, 게이트가 아닙니다. 일치하는 입력에 대해 전문화된 워크플로우는 ~3분까지 모든 것을 처리합니다 — 어떤 워크플로우에 진입할지는 의도(입력 유형, 텍스트의 경우 주제)에 의해 결정되며, 길이에 의해서가 아닙니다. 길이는 상단 끝에서만 중요합니다: 진정으로 긴 작품(3-5분 튜토리얼, 5분+ 심층 분석)은 다른 레지스터이므로 /general-video로 라우팅됩니다. ≤~3분 대역 내에서 세 번째 축이 두 텍스트 기반 워크플로우를 구분합니다: 주제 — 마케팅되는 제품 vs 설명되는 주제(아래 단계 3의 명확화 규칙 참조).

길이 / 입력제품 출시 (URL / 브리프 / 스크립트)일반 웹사이트 / URLGitHub PR / 코드 변경주제 / 기사 / 노트 (제품 없음, URL 없음)기존 비디오 (토킹헤드) †
≤ ~3 분/product-launch-video/website-to-video/pr-to-video/faceless-explainer/embedded-captions · /graphic-overlays †
3-5분 튜토리얼/general-video/general-video/general-video/general-video/embedded-captions · /graphic-overlays †
5분+ 심층 분석/general-video/general-video/general-video/general-video/embedded-captions · /graphic-overlays †
정적 / 루프/general-video/general-video/general-video/general-video/general-video

현재 범위: ≤ ~3 분 대역에는 제품 출시 / 일반 웹사이트 / GitHub-PR / 주제 입력을 위한 전용 워크플로우가 있습니다(URL은 _종류_로 분할한 후 _의도_로 분할 — 단계 3 참조). 기존 비디오 열은 모든 길이에서 적용됩니다 — /embedded-captions(자막/서브타이틀) 또는 /graphic-overlays(디자인된 그래픽 오버레이)에 의해 의도에 따라 분할됩니다(단계 2 참조). 다른 모든 셀은 /general-video — 일반 HTML 컴포지션 작성 흐름(입력 및 길이 무관): ~3분 초과 모든 것(3-5분 / 5분+ 행) 및 모든 정적 / 루프 형식. 라우터는 창작 가능한 비디오에 대해 막다른 길이 없습니다. 유일하게 진정한 "일반 / 없음" 답변은 HyperFrames 자체 외부의 요청(예: 완성된 비디오 파일의 NLE 스타일 편집 — 재타이밍, 재색상화, 재프레이밍, 재정렬, 오디오)입니다.

† 기존 영상은 길이가 아닌 의도에 따라 분할됩니다. 자막/서브타이틀 → /embedded-captions, 디자인된 그래픽 오버레이/패키징 — 하단 3분할, 데이터 콜아웃, 제목 카드, 인용구 — → /graphic-overlays. 둘 다 클립 위에 오버레이되며, 클립은 그대로 재생됩니다. 어느 것도 영상 자체를 편집하지 않습니다.

장르 단락(테이블보다 우선). 짧은(~10초 미만), 내레이션 없는, 디자인 주도의 모션 그래픽 — 키네틱 타입, 통계/차트 히트, 로고 스팅, 하단 3분할/오버레이, 또는 애니메이션 트윗/헤드라인/캡처된 페이지 하이라이트 — 입력에 관계없이 /motion-graphics로 라우팅됩니다. 이는 출력 장르이지 입력 유형이 아니므로, 요청이 명확히 모션 우선이고 내레이션이 없을 때 입력 유형 테이블보다 우선합니다(단계 2 참조). 더 길거나 내레이션이 있는 처리는 입력 유형별로 라우팅되거나 /general-video로 이동합니다.

기존 컴포지션 마이그레이션 (특수 사례)

위 테이블은 입력에서 생성하는 비디오를 위한 것입니다. 하나의 워크플로우가 그 밖에 있습니다: 사용자가 명시적으로 기존 Remotion (React) 컴포지션을 HyperFrames로 이식/변환/마이그레이션할 것을 요청하는 경우 → /remotion-to-hyperframes. 이는 소스 번역이지 입력에서 생성이 아니므로 INPUT × LENGTH 셀이 없습니다. 명시적인 마이그레이션 언어("내 Remotion 프로젝트 이식", "이 Remotion comp 변환", "이것을 HyperFrames로 다시 작성")에서만 여기로 라우팅하세요 — Remotion을 우연히 언급하는 것은 트리거가 아닙니다. 기본값은 생성 테이블 또는 /hyperframes-core입니다.

라우팅 절차

  1. 입력 유형 + 대상 길이 결정. 라우팅은 비디오가 무엇에 관한 것인지 — 주제와 입력을 알아야 합니다. 주제 자체가 지정되지 않은 경우(예: URL, 명명된 제품, 주제 또는 작업할 자산 없이 "우리 것에 관한 비디오 제작"), 또는 입력 유형을 알 수 없는 경우, 워크플로우에 진입하기 전에 물어보세요 — 먼저 명확히 하세요. 워크플로우 기술을 호출한 다음 질문하지 마세요. 워크플로우에 진입하는 것이 라우팅 결정 자체이기 때문입니다. 최대 2개의 명확화 질문을 하세요:
    • "입력이 무엇인가요? — 제품(URL 또는 브리프), 일반 웹사이트/URL, GitHub PR/코드 변경, 설명할 주제 또는 기사, 아니면 자막을 추가할 기존 토킹헤드 비디오인가요?"
    • "대상 길이는 얼마인가요? — 약 3분 이하, 아니면 더 긴(3-5분 튜토리얼 / 5분+ 심층 분석) 것인가요?"
    • 사양 기본값 — 물어보지 말고 명시하세요 (이것들은 경로에 영향을 주지 않으므로 라우팅을 차단하지 마세요): 종횡비 16:9(엔진은 9:16 세로도 지원 — 사용자가 TikTok / Reels / Shorts와 같은 세로 대상을 지정하는 경우에만 전환), 내레이션/자막 언어 = 사용자의 언어. 사용자가 반발할 때만 확인하세요. 선택한 워크플로우는 자체 0단계에서 자체 세부 사항을 다시 확인합니다.
  2. 입력 유형(의도)별로 먼저 선택하세요. 길이는 상한선일 뿐, 게이트가 아닙니다.
    • 짧은 디자인 주도 모션 그래픽 (장르 단락, 입력 테이블보다 우선) — 모션 자체가 메시지: 키네틱 타입, 통계/숫자 카운트업, 차트 히트, 로고 스팅, 하단 3분할/오버레이, 또는 애니메이션 트윗/헤드라인/캡처된 페이지 하이라이트; 일반적으로 ~10초 미만, 내레이션/음성 해설 없음 → /motion-graphics. 이는 출력 장르이지 입력 유형이 아닙니다 — 요청이 명확히 빠르고, 내레이션 없으며, 디자인 주도 모션 작품일 때 입력에 관계없이 여기로 라우팅하세요. 동일한 자료의 더 길거나 내레이션이 있는 처리는 이것이 아닙니다(입력 유형별로 라우팅하거나 /general-video).
    • 기존 토킹헤드 비디오 (사용자가 클립을 가지고 있고 위에 무언가를 추가하려는 경우) → 의도별로 분할, 모든 길이에서 (입력 유형이 길이보다 우선): 자막/서브타이틀 (말하는 단어를 읽을 수 있는 텍스트로) → /embedded-captions; 디자인된 그래픽 오버레이 — 하단 3분할, 데이터 콜아웃, 제목 정보 카드, 인용구, 그래픽 패키지 편집 → /graphic-overlays. (영상 자체 편집 — 재타이밍, 재색상화, 재프레이밍, 재정렬, 오디오 — NLE 스타일이며 범위 밖입니다. § HyperFrames가 할 수 없는 것 참조.)
    • GitHub PR / 코드 변경 (github.com/<owner>/<repo>/pull/<N> 링크, owner/repo#N 참조, 또는 "이 PR") → /pr-to-video (최대 ~3분).
    • 그 외 (제품 URL / 브리프 / 주제 텍스트): 의도가 단계 3을 통해 워크플로우를 선택하며, ~3분까지 모든 것을 처리합니다 — 짧은 15-30초 프로모션과 ~100초 설명 영상 모두 길이가 아닌 의도에 의해 라우팅됩니다. 대상이 명확히 ~3분 초과일 때만(3-5분 튜토리얼, 5분+ 심층 분석) /general-video(길이 무관 폴백 — 단계 4 참조)로 라우팅하세요. 진정으로 긴 작품을 ≤~3분 워크플로우에 강제로 넣지 마세요 — 의도는 대역 내에서 결정하고, 나머지는 /general-video가 처리합니다.
  3. ≤~3분 URL / 텍스트 입력 명확화 (의도 분할). 두 가지 분할:
    • URL 종류 + 의도 — URL이 더 이상 PLV에 자동으로 승리하지 않습니다. _종류_가 _의도_를 결정합니다: GitHub PR 링크(.../pull/<N>, owner/repo#N, "이 PR") → /pr-to-video; 그 외 웹사이트 URL은 의도에 따라 분할됩니다 — 특정 제품 또는 SaaS 마케팅/출시/홍보 → /product-launch-video; 일반 사이트 → 비디오 (사이트 투어, 포트폴리오/블로그/랜딩 페이지 쇼케이스, 사이트 자체 비주얼의 소셜 클립, 또는 "이 사이트를 비디오로 전환") → /website-to-video. 둘 다 headless Chrome을 사용하여 크롤링합니다. PR URL은 gh를 통해 읽습니다. 사이트 URL이 제품 출시인지 일반 사이트 비디오인지 명확하지 않은 경우 한 가지 질문을 하세요.
    • 제품 vs 주제 (텍스트, URL 없음) — 결정적인 질문은 비디오가 무엇에 관한 것인지이며, 입력 형식이 아닙니다:
      • 마케팅, 출시 또는 홍보되는 특정 제품/회사/SaaS/앱/웹사이트 → /product-launch-video.
      • 설명되는 개념/주제/기사/어떻게 작동하는지, 제품도 URL도 없음 → /faceless-explainer.
      • 타이브레이커: "홍보/출시/판매/우리 제품" 문구 → PLV. "설명/가르치기/X 작동 방식/X가 무엇인지" 제품 없음 → 무면. 무면의 출하 스타일은 항상 pin-and-paper입니다.
      • 붙여넣은 URL 없이 명명된 사이트는 여전히 PLV입니다. 제품이나 그 웹사이트를 언급하는 스크립트("우리 사이트는 acme.io입니다", "<브랜드> 홍보")는 클릭 가능한 링크가 없어도 PLV로 라우팅됩니다 — PLV는 웹 검색으로 사이트를 검색하고 브랜드 자산을 크롤링할 수 있습니다(사용자가 거부하지 않는 한 → 캡처 없음 사전 설정 모드). URL을 붙여넣지 않는다고 해서 무면/캡처 없음 작업이 되는 것은 아닙니다. 제공된 스크립트의 축어적 대 구조 재구성 선택은 PLV 내부 사항이며 경로를 변경하지 않습니다.
      • 충돌하는 신호 → 묻고, 추측하지 마세요. 제공된 소스가 제품의 자체 마케팅(랜딩 페이지, _해당 플랫폼_에 대한 프로모션 블로그)이지만 사용자가 명시적으로 홍보 제거를 요청하는 경우 — 기본 개념의 중립적 설명자, 광고 아님 — 이를 진정으로 모호한 것으로 처리하세요(비디오는 제품용인가 설명자용인가?). 사용자에게 질문하고 거기에 따라 라우팅하세요.
  4. 초과 길이와 정적/루프는 /general-video로 라우팅. 이 워크플로우는 모든 유형의 비디오 입력(짧고 긴, 스토리텔링 / 설명적/절차적, 정적/루프)을 위한 보편적인 HTML 컴포지션 작성 흐름입니다. 전용 워크플로우가 있는 동일한 입력 유형에 대해 길이 기반 전용 경로가 아닙니다 — "웹사이트를 ~3분 미만 비디오로 전환"은 /website-to-video로 가고, "동일한 웹사이트를 3-5분 튜토리얼로 전환"은 여기로 옵니다. 여기에 라우팅되는 조건 (입력 유형 무관):
    • 대상 길이가 ~3분을 초과합니다 (3-5분 튜토리얼, 5분+ 심층 분석).
    • 출력이 정적 이미지 또는 루핑 애니메이션입니다 — 이러한 형식에는 전용 워크플로우가 없습니다. *여기에 라우팅한다고 해서 길이/형식이 입력을 덮어쓴다는 의미는 아닙니다 — general-video는 제공된 입력에서 작동합니다. 단지 전용 =~3분 의도 기반 워크플로우를 사용하지 않는다는 의미입니다.

워크플로우 진입 시: 순수한 하우스키핑 단계는 스킵하세요. 사용자가 명확한 의도를 가진 정확한 입력을 제공하는 경우(예: 제품 출시 비디오를 위한 URL), 라우팅은 즉시 해당 워크플로우 기술을 로드해야 합니다. 0단계 일반 참조가 필요한 각 워크플로우(URL과 제품 이름이 명확할 때 "먼저 어떤 종류의 비디오를 원하는지 알려주세요"와 같은 질문)는 불필요한 마찰입니다. 이 라우터가 이미 결정을 내렸으므로 사용자를 다시 찾을 필요가 없습니다. 사용자가 모호할 때(예: "가상의 SaaS를 위한 비디오 만들기" 또는 입력 없음)만 질문하여 명확히 하세요 — 명확히 한 후에는 게이팅 질문 없이 워크플로우를 로드하세요.


참조를 위해 다시 생성: 이 기술은 HyperFrames 시스템의 진입점 역할을 하며, 비디오 제작 요청을 적절한 워크플로우로 안내합니다. 의사 결정 테이블은 입력 유형(URL, PR, 주제 등)과 대상 길이(약 3분 이하 또는 초과)를 기준으로 합니다. 또한 시스템 범위를 명확히 하여, 결정론적 렌더링 요구 사항, 비디오 편집 제한, 단방향 Remotion 가져오기 등 HyperFrames가 할 수 없는 작업을 문서화합니다.

관련 스킬