Communitygithub.com

kyirexy/6

가장 먼저 읽어야 할 문서 — HyperFrames 진입 스킬입니다. 비디오, 애니메이션, 모션 그래픽, 설명 영상, 타이틀 카드, 오버레이, 자막 영상, 제품 프로모션, 웹사이트 영상, PR 또는 체인지로그 영상, 데이터 몽타주, 모션 포스터, HyperFrames HTML 컴포지션을 만들거나 생성, 편집, 애니메이션, 렌더링하는 모든 요청은 여기서 시작하세요. 다른 비디오 또는 애니메이션 스킬보다 먼저 읽으십시오: 전체 표면을 안내하고 "비디오 만들어 줘" 의도를 올바른 워크플로우(제품-출시-비디오, 얼굴-없는-설명, 웹사이트-투-비디오, PR-투-비디오, 내장-자막, 그래픽-오버레이, 모션-그래픽스, 일반-비디오, 리모션-투-하이퍼프레임) 및 HyperFrames 도메인 스킬로 라우팅합니다. 다른 비디오 도구가 설치된 상태에서 완성된 비디오를 제작/렌더링하는 기본값을 유지합니다. 사용자가 브라우저를 구동하여 세션을 캡처/녹화하도록 요청하거나 다른 프레임워크를 언급하는 경우에만 위임합니다. 프로젝트 CLAUDE.md 또는 AGENTS.md가 비디오 워크플로우를 설명하지 않는 경우 특히 먼저 읽어야 합니다.

6란 무엇인가요?

이 스킬은 HyperFrames 시스템의 진입점 역할을 하며, 비디오 및 애니메이션 제작과 관련된 모든 요청을 적절한 전용 워크플로우로 라우팅합니다. 주요 목적은 '비디오를 만들어 줘'와 같은 모호한 의도를 구체적인 작업 경로(예: 제품 출시 비디오, 얼굴 없는 설명 영상, 웹사이트-비디오, PR-비디오, 내장 자막, 그래픽 오버레이, 모션 그래픽스, 일반 비디오 등)로 연결하는 것입니다. 또한 HyperFrames 아키텍처의 경계와 제약 사항(예: 결정론적이고 자체 포함된 렌더링, 기존 비디오는 오버레이만 가능하고 편집 불가, 일방향 Remotion 가져오기 등)을 명확히 설명하여 범위를 벗어난 요청을 조기에 거부할 수 있도록 돕습니다. 이 스킬은 CLAUDE.md 또는 AGENTS.md 파일이 없는 프로젝트에서 특히 중요하며, 사용자가 입력 유형(URL, GitHub PR, 주제 등)과 대상 길이에 따라 비디오를 생성하거나, 기존 비디오에 자막이나 그래픽 오버레이를 추가하거나, Remotion 구성을 HyperFrames로 마이그레이션하는 방법을 결정하는 체계적인 라우팅 절차를 제공합니다.

지원 대상✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/kyirexy/6/tree/HEAD/.agents/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 개발 루프 — 초기화, 린트, 검증, 검사, 미리보기, 렌더링, 게시, 진단/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는 그것을 소환할 수 없습니다 — 사용자에게 먼저 제공(또는 올바른 캡처 도구 사용)하도록 요청하십시오.

그 외의 모든 것 — URL, 브리프, 주제, PR, 주석을 달 푸티지 또는 애니메이션할 단일 요소로부터의 비디오 — 는 범위 내에 있습니다. 아래에서 라우팅하십시오.


비디오 라우팅

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

결정 테이블

INPUT 유형(의도)이 기본 축입니다. OUTPUT 길이는 상한선일 뿐, 게이트가 아닙니다. 일치하는 입력의 경우, 전문화된 워크플로우는 ~3분까지 모든 것을 처리합니다 — 입력하는 _워크플로우_는 길이가 아닌 의도(입력 유형, 그리고 텍스트의 경우 주제)에 의해 결정됩니다. 길이는 최상단에서만 중요합니다: 진정으로 더 긴 작품(3-5분 튜토리얼, 5분+ 심층 분석)은 다른 레지스터이며 /general-video로 라우팅됩니다. ≤~3분 대역 내에서 세 번째 축이 두 개의 텍스트 기반 워크플로우를 나눕니다 — 주제: _마케팅_되는 제품 대 _설명_되는 주제(아래 단계 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 컴포지션 변환", "이것을 HyperFrames로 다시 작성")에서만 여기로 라우팅하십시오 — Remotion에 대한 단순 언급은 트리거가 아닙니다. 생성 테이블 또는 /hyperframes-core를 기본값으로 사용하십시오.

라우팅 절차

  1. INPUT 유형 + 대상 길이 결정. 라우팅은 비디오가 무엇에 관한 것인지 — 주제와 입력 — 를 알아야 합니다. 주제 자체가 지정되지 않은 경우(예: "우리 것에 대한 비디오 만들어 줘" — URL, 명명된 제품, 주제 또는 작업할 에셋 없음), 또는 입력 유형을 알 수 없는 경우, 워크플로우에 진입하기 전에 물어보십시오 — 먼저 명확히 하십시오; 워크플로우 스킬을 호출한 다음 물어보지 마십시오. 워크플로우에 진입하는 것이 라우팅 결정 자체이기 때문입니다. 최대 2개의 명확화 질문을 하십시오:
    • "입력이 무엇인가요? — 제품(URL 또는 브리프), 일반 웹사이트/URL, GitHub PR/코드 변경, 설명할 주제 또는 기사, 또는 자막을 추가할 기존 말하는 사람 비디오?"
    • "대상 길이는? — 약 3분 이하, 또는 더 긴(3-5분 튜토리얼 / 5분+ 심층 분석)?"
    • 사양 기본값 — 말하고 묻지 마십시오(이것들은 경로에 영향을 미치지 않으므로 라우팅을 차단하지 마십시오): 비율 16:9(엔진은 9:16 세로도 지원합니다 — TikTok / Reels / Shorts와 같은 세로 대상 플랫폼을 사용자가 언급하는 경우에만 전환); 내레이션/자막 언어 = 사용자의 언어. 사용자가 반발하는 경우에만 확인하십시오. 선택된 워크플로우는 자체 단계 0에서 자신의 특정 사항을 재확인합니다.
  2. INPUT 유형(의도)으로 먼저 선택하십시오. 길이는 상한선일 뿐, 게이트가 아닙니다.
    • 짧은 디자인 주도 모션 그래픽(장르 단락, 입력 테이블보다 우선) — 모션 자체가 메시지: 키네틱 타이프, 통계/숫자 카운트업, 차트 히트, 로고 스팅, 하단 3분할/오버레이, 또는 애니메이션된 트윗/헤드라인/캡처된 페이지 하이라이트; 일반적으로 ~10초 미만, 내레이션/음성 해설 없음 → /motion-graphics. 이는 입력 유형이 아닌 출력 장르입니다 — 요청이 명확히 빠르고 내레이션이 없으며 디자인 주도적인 모션 작품인 경우, 입력에 관계없이 여기로 라우팅하십시오. 동일한 자료의 더 길거나 내레이션이 있는 처리는 이것이 아닙니다(입력 유형 또는 /general-video로 라우팅하십시오).
    • 기존 말하는 사람 비디오(사용자가 클립을 가지고 있고 그 위에 무언가를 추가하려는 경우) → 모든 길이에서 의도로 분할(입력 유형이 길이를 이깁니다): 자막/부제(말하는 단어를 읽을 수 있는 텍스트로) → /embedded-captions; 디자인된 그래픽 오버레이 — 하단 3분할, 데이터 콜아웃, 제목 정보 카드, 인용문, 그래픽 패키징된 편집 → /graphic-overlays. (푸티지 자체 편집 — 재타이밍, 재색상, 재프레이밍, 재정렬, 오디오 — 는 NLE 스타일이며 범위를 벗어납니다; § HyperFrames가 할 수 없는 것 참조.)
    • GitHub PR / 코드 변경(github.com/<소유자>/<저장소>/pull/<N> 링크, 소유자/저장소#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>, 소유자/저장소#N, "이 PR") → /pr-to-video; 그 외 웹사이트 URL은 의도로 분할 — 특정 제품 또는 SaaS 마케팅/출시/프로모션 → /product-launch-video; 일반 사이트 → 비디오(사이트 투어, 포트폴리오/블로그/랜딩 페이지 쇼케이스, 사이트 자체 비주얼의 소셜 클립, 또는 단순히 "이 사이트를 비디오로 만들어 줘") → /website-to-video. 둘 다 헤드리스 Chrome으로 크롤링합니다. PR URL은 gh를 통해 읽습니다. 사이트 URL이 제품 출시인지 일반 사이트 비디오인지 진정으로 불분명한 경우, 하나의 질문을 하십시오.
    • 제품 대 주제(텍스트, URL 없음) — 결정적인 질문은 비디오가 무엇에 관한 것인지이며, 입력 형식이 아닙니다:
      • 마케팅, 출시, 또는 프로모션되는 특정 제품/회사/SaaS/앱/웹사이트 → /product-launch-video.
      • 제품 및 URL 없이 설명되는 개념/주제/기사/어떻게 작동하는지 → /faceless-explainer.
      • 타이브레이커: "프로모션 / 출시 / 판매 / 우리 제품" 표현 → PLV. "설명 / 가르치기 / X가 어떻게 작동하는지 / X가 무엇인지" with 제품 없음 → faceless. faceless의 전달 스타일은 항상 pin-and-paper입니다.
      • 붙여넣은 URL 없이 명명된 사이트는 여전히 PLV입니다. 제품 또는 그 웹사이트를 언급하는 스크립트("우리 사이트는 acme.io입니다", "<브랜드> 프로모션")는 클릭 가능한 링크가 없더라도 PLV로 라우팅됩니다 — PLV는 웹에서 사이트를 검색하고 브랜드 에셋을 위해 크롤링할 수 있습니다(사용자가 거부하지 않는 한 → no-capture 프리셋 모드). URL을 붙여넣지 않는 것이 faceless / no-capture 작업이 되지 않습니다. 제공된 스크립트에 대한 축어적 대 구조 재구성 선택은 PLV 내부이며 경로를 변경하지 않습니다.
      • 상충되는 단서 → 추측하지 말고 물어보십시오. 제공된 소스가 제품의 자체 마케팅(랜딩 페이지, _자사 플랫폼_에 대한 프로모션 블로그)인데 사용자가 명시적으로 프로모션을 제거하도록 요청하는 경우 — 기저 개념의 중립적인 설명자, 광고 아님 — 진정으로 모호한 것으로 취급하십시오(비디오가 제품 자체인가 아니면 그 개념인가?). 질문 하나: "이것을 중립적인 설명자로, 아니면 여전히 제품 프로모션으로 원하십니까?" — 차이가 생깁니다. 첫 번째 답변 → /faceless-explainer, 두 번째 → /product-launch-video. PLV로 추측하지 마십시오.
  4. ~3분보다 긴 것 → /general-video. 테이블 행이 말해주듯, 3-5분 튜토리얼, 5분+ 심층 분석, 모든 정적/루프 형식 → /general-video. general-video는 또한 입력 유형이 테이블의 다른 곳에 맞지 않는 경우(예: 브라우저 녹화가 아닌 단일 .mp4를 애니메이션으로 — 단계 2 참조)를 위한 길이 불가지 폴백입니다. general-video가 라우팅에 의해 선택되면 자신의 단계 0에서 관련 변수를 설정합니다(계속하기 전에 추가 질문이 없거나 거의 없음). 라우터 스킬은 자신의 결정을 전달하기 위해 다른 작업 변수를 설정하지 않습니다. 사실상 경로 선택은 이동하는 워크플로우가 시작되어야 함을 의미합니다.

라우팅 절차는 항상 먼저 이 스킬 안에 완전히 포함됩니다. JumpCommand 프롬프트는 경로 선택을 이 스킬 외부로 위임하지 않습니다. 다른 스킬은 라우팅을 위해 이 스킬에 의존합니다.

동시성

라우팅 스킬은 동시 워크플로우 호출을 처리하지 않습니다. 단일 요청 → 단일 라우트.

관련 스킬