Communitygithub.com

courtneymgabrus-star/Video

HyperFrames 구성을 작성하거나 편집합니다. 일반 비디오, 브랜드 릴, 몽타주, 푸티지 리믹스, 자유 형식 제작에 적합합니다. 새 프로젝트는 먼저 hyperframes를 통해 생성하세요.

Video란 무엇인가요?

이 스킬은 일반 비디오 제작 및 편집을 위한 HyperFrames 워크플로우를 제공합니다. 주로 긴 길이의 멀티 씬 프로젝트, 브랜드 릴, 시즐 릴, 몽타주, 정적 루프, 타이틀 카드, 푸티지 리믹스 등 특수 워크플로우가 적합하지 않은 경우에 사용됩니다. 워크플로우는 먼저 사전 설치 및 업데이트를 확인하고, 사용량을 점검하며, 소스 어댑터(미디어, Figma)를 적용하고, 프로젝트 상태에 따라 초기화합니다. 그런 다음 이야기 구조와 디자인을 계획하고, 블루프린트나 규칙을 사용하여 애니메이션과 구성을 실행하며, 렌더링 및 내보내기를 위해 공동 편집 기술과 최종 게이트를 사용합니다. 이 스킬은 Claude Code, Cursor, GitHub Copilot과 같은 AI 코딩 에이전트와 함께 작동하도록 설계되었습니다. 에이전트가 따라야 할 정확한 단계를 제공하여 완전 자동화(`flow: automation`) 또는 협업(`flow: companion`) 모드에서 작동하며, 자세한 생성 지침과 품질 관문을 제공합니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/courtneymgabrus-star/Video/tree/HEAD/.agents/skills/general-video

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

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

문서

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

일반 비디오

워크플로우가 방금 읽지 않은 경우 시작 시 npx hyperframes usage --json을 실행하고, 초안 작성 후 및 렌더링 전과 같은 중요한 시점에 다시 확인하세요. 사용 가능한 윈도우와 재설정 시간을 읽으세요. 사용량을 알 수 없는 경우 허용량을 추측하지 말고 말하고, 사용자와 범위 및 워크플로우 선택을 유지하세요.

이 워크플로우에 의존하기 전에 다음을 실행하세요:

npx hyperframes skills update general-video

성공적인 no-op는 스킬이 최신 상태임을 의미합니다. 메모리에서 계속 진행하는 대신 업데이트 실패를 표시하세요.

1. 교차 소스 어댑터 적용

  • 미디어: 오디오, 이미지, 아이콘, 로고, 음성, 그레이딩, LUT, 효과, 캡션 또는 미디어 작업이 필요한 경우 /media-use를 로드하고 ../media-use/references/resolve.md (해결, 채택, 재사용) 및 ../media-use/references/setup-providers.md (제공자, 인증)를 따르세요. 모호한 피드백과 명명된 스타일은 편집 전에 ../media-use/references/media-treatments.md를 사용하세요. 지원되는 미디어 효과를 CSS/SVG/불투명도로 즉석에서 구현하지 마세요. 첫 번째 인증된 제공자 작업 전에 npx hyperframes auth status를 실행하고 출력을 그대로 전달하세요. 로그아웃된 경우 ../hyperframes/references/brief-contract.md의 게이트를 적용하세요: 협업 모드는 로그인 또는 명시적인 오프라인 선택을 기다립니다. 자율 모드는 상태를 명시하고 사용 가능한 오프라인 제공자를 통해 계속 진행합니다. 필요한 기능을 충족할 수 있는 오프라인 제공자가 없으면 차단기를 표시하세요. 로컬 채택만으로는 인증 게이트가 필요하지 않습니다.
  • Figma: 입력이 figma.com URL인 경우 먼저 /figma를 실행하세요. 내보낸 자산, 토큰, 컴포넌트 또는 스토리보드 프레임에서 빌드하세요. SVG 삭제, 미디어 출처 및 브랜드 토큰 바인딩을 건너뛰므로 원시 Figma 커넥터 호출을 사용하지 마세요.

이러한 어댑터는 /hyperframes에서 선택한 워크플로우를 변경하지 않습니다.

2. 프로젝트 상태에서 시작

일치하는 첫 번째 행을 적용하고, 아래 상태 행을 평가하지 마세요:

상태작업
특정 편집편집을 수행하고 기존 프로젝트 결정을 유지한 다음 영향을 받는 검사를 다시 실행하세요. 발견 단계를 다시 열지 마세요.
BRIEF.md 파일이 존재함읽으세요. workflow가 다른 워크플로우를 지정하고 flow가 companion이 아닌 경우 전달하세요. 브리핑 질문을 하지 마세요.
브리핑은 없지만 hyperframes.json 또는 STORYBOARD.md 파일이 존재함파일과 기록된 기본 설정에서 재개하세요. 알려진 사실에서만 BRIEF.md를 백필하세요.
새로 생성/hyperframes와 의도 레이어를 실행하세요. workflow: general-video 또는 flow: companion인 경우에만 여기로 돌아오세요.

새 프로젝트의 경우 브리핑에서 kebab-case 디렉토리 이름을 선택하고 브리핑을 작성하기 전에 스캐폴딩하세요:

npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=general-video

그런 다음 ../hyperframes/references/brief-format.md를 사용하여 프로젝트 루트에 BRIEF.md를 작성하세요. 기존 프로젝트에서 루트는 hyperframes.json이 포함된 디렉토리입니다. 브리핑 형식이 지정한 확인된 기본 설정 기반 필드만 기록하고, node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes <PROJECT_ROOT>를 사용하세요. 추론된 기본값은 절대 기록하지 마세요. 여기서 <MEDIA_DIR>은 설치된 /media-use 스킬 디렉토리이고 <PROJECT_ROOT>는 hyperframes.json이 포함된 디렉토리입니다. 의도 레이어가 레시피를 채택한 경우 node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes <PROJECT_ROOT> --name <name>을 사용하여 지금 적용하고 다시 묻지 마세요.

3. 실행 형태 해석

../hyperframes/references/brief-contract.md의 정식 용어만 사용하세요:

필드의미효과
flow누가 주도하는지automation: 경로를 선택하고 실행합니다. companion: 대화를 통해 공동 창작합니다.
storyboard빌드 전 계획, 스케치 및 검토yes: 계획 및 스케치 검토 실행(boards/storyboard.html, 형식은 ../hyperframes-creative/references/storyboard-recipe.md에 있음). no: 건너뜁니다.
파생된 mode체크포인트 게이트가 작동하는 방식브리핑 계약을 따르세요. 사용자에게 모드 이름을 묻지 마세요.

이러한 상태에 대한 동의어를 만들지 마세요. 진행 중인 "그냥 만들어" 신호는 의도 레이어에서 처리되며 flow: automation, storyboard: no로 도착합니다.

  • flow: automation의 경우 경로를 선택하고 첫 번째 진행 업데이트에서 한 줄로 명시하세요.
  • 특정 편집의 경우 새 경로를 만들지 않고 편집을 수행하세요.

하드 컷, 트림, 스플라이스 또는 기존 푸티지 재정렬의 경우 동일한 비디오 소스를 여러 클립 요소로 복제하세요. 각 복사본에서 data-media-start와 data-duration으로 소스 범위를 설정한 다음 data-start로 작성된 배치/순서를 설정하세요. 각 비디오 세그먼트는 사운드를 유지합니다. 사운드는 클립에 남아 있습니다(data-has-audio="true"). 따라서 비디오를 자르면 사운드도 잘립니다. /hyperframes-core가 이 시간 편집을 소유합니다. 줌, 펀치, 팬, 크롭, 마스크 또는 내부 래퍼의 clip-path와 같은 시각적 속성 애니메이션에만 /hyperframes-keyframes를 사용하세요. ../hyperframes-core/references/creator-editing-recipes.md에서 전체 계약을 복사하세요.

협업 흐름

flow: companion인 경우:

  • BRIEF.md를 읽고 수락된 ## Assets 및 ## Customizations를 프로젝트 아티팩트와 조정하세요. 수락되었지만 아직 보류 중인 작업을 완료하고, 완료된 작업은 그대로 두고, 수락된 기능을 새로운 것처럼 다시 제공하지 마세요.
  • 계약자가 아닌 디렉터로 도착하세요. 협업을 선택한 사용자는 참여와 품질을 선택했습니다. 정직한 응답은 방어할 수 있는 가장 작은 버전이 아니라 디자인할 수 있는 최고의 버전입니다. 첫 번째 계획은 최고 수준의 처리입니다: 스토리 아크(가장 가까운 장르 렌즈 빌리기 — 메뉴 § 장르 렌즈), 디자인 사양, 각 장면의 모션 처리(§ 5의 계획 규율에 따라 이름으로 인용), 전환, 오디오 정체성 — 음악 및 사운드 마크, 또는 의도적인 침묵 — 사용자의 자료 배치, 디자인된 시작과 끝. 각 레이어가 추가하는 내용을 한 줄로 말하고, 비용이 많이 드는 것(렌더링 시간, 로그인, 청구)을 이름을 지정할 때 표시하세요. 사용자는 처리를 다듬습니다. 승인별로 조립할 필요가 없어야 합니다.
  • 최고 수준은 도구 상자가 아닌 컨셉에 속합니다. 모든 레이어는 브리핑의 메시지를 제공해야 합니다. 같은 방식으로 모든 비디오를 꾸밀 처리의 경우 장식입니다. 기술은 최고 수준까지 올라갑니다. 콘텐츠는 요청된 것보다 절대 커지지 않습니다(§ 6).
  • 체크포인트 사이에 ../hyperframes/references/capability-menu.md는 두 가지 방식으로 작동합니다. 트리거 목록으로: 사용자가 입력을 언급하거나 빌드가 필요에 도달하면 관련 기능을 제공합니다. 각 패스의 업그레이드 채널로: 계획, 스케치 또는 빌드 체크포인트는 사용자가 보고 있는 자료를 가리키는 하나 또는 두 개의 추적된 제안을 전달할 수 있습니다("씬 3의 통계는 카운트업 처리를 원합니다"). 제공하기 전에 읽으세요. 전체 카탈로그를 덤프하지 마세요.
  • 사용자가 기능을 수락한 후 해당 아티팩트를 생성하고 일치하는 BRIEF.md 본문 섹션에 즉시 결정을 기록하세요. 사용자가 명시적으로 변경하는 경우에만 프론트매터 필드를 다시 작성하고 확인된 기본 설정을 기록하세요.
  • 동일한 스토리보드, 검증, 최종 미리보기 및 렌더링 승인 게이트를 유지하세요. 협업은 누가 조종하는지 변경할 뿐, 품질에 필요한 것은 변경하지 않습니다.

4. 각 단계 전에 필요한 지식 로드

조건이 일치하는 경우 다음 읽기는 필수입니다:

조건조치 전에 읽기
모든 구성 HTML 또는 씬 레이아웃/hyperframes-core; 레이아웃 계약을 위해 references/determinism-rules.md 사용
모든 중요하지 않은 생성 또는 시각적 처리/hyperframes-creative → references/house-style.md 및 references/video-composition.md
모든 모션, 애니메이션 또는 씬 전환/hyperframes-animation; 일치하는 규칙, 어댑터, 블루프린트 또는 전환 참조로 라우팅 따르기
storyboard: yes../hyperframes/references/storyboard-format.md 및 ../hyperframes/references/review-loop.md
모든 미디어 자산 또는 작업(내레이션, BGM, SFX, 캡션, 그레이딩 또는 변환 포함)/media-use (호스트 앱의 자체 음악 및 사운드 효과 도구가 해당 항목에 대해 우선); 프레임워크 재생 및 배치의 경우 /hyperframes-core → references/variables-and-media.md도 읽으세요.
멀티 씬 어셈블리../hyperframes/references/production-loop.md
flow: companion, 첫 번째 계획 전/hyperframes-creative → references/story-spine.md 및 references/house-style.md; 가장 가까운 장르 렌즈 및 전체 ../hyperframes/references/capability-menu.md — 최고 수준 처리는 이들로부터 설계되며, 기억에서 가져오지 않음
협업 기능 제공, 캡처, 비트 그리드, 생성 비디오, 맵, 게시 또는 교차 워크플로우 기능../hyperframes/references/capability-menu.md
최종 승인 전에 디자인 사양이 존재함/hyperframes-creative → references/design-adherence.md

이러한 읽기를 기억으로 대체하지 마세요. 프로그레시브 공개는 일치하는 참조가 실제로 로드된 경우에만 컨텍스트를 저장합니다.

5. 구성 실행

이 종속성 순서를 사용하세요. 입력이 없는 경우에만 단계를 건너뛰세요.

  1. 계획. 뷰어 아크, 구조, 리듬 및 기간 드라이버를 명시하세요. 짧은 단일 씬에는 하나의 파일을 사용하세요. 세 개 이상의 하드 씬 컷 또는 재사용되는 씬에는 하위 구성을 사용하세요. 내레이션 아크는 /hyperframes-creative → references/story-spine.md, 리듬은 references/beat-direction.md, 구조는 /hyperframes-core → references/composition-patterns.md를 읽으세요. 오픈 엔드 멀티 씬 브리핑의 경우 /hyperframes-creative → references/prompt-expansion.md를 통해 프롬프트를 확장하세요. 멀티 씬 계획은 각 씬의 형태를 인용합니다: 하나가 맞는 경우 /hyperframes-animation → blueprints-index.md의 블루프린트 ID, 또는 맞는 것이 없을 때 구성하는 명명된 규칙(rules-index.md에서). 모션 이름은 해당 인덱스에서 가져오며 결코 발명되지 않습니다. 스토리 진실이 어떤 씬이 존재하는지 결정합니다. 인용문이 그것들을 꾸밉니다. 직접 명명된 모양을 만들 계획을 세우기 전에 라이브 카탈로그를 검색하세요: 모든 모양, 효과, 처리 또는 전환에 대해 브리핑에서 "CRT 스캔라인", "글리치", "필름 그레인", "샤이머 스위프", "컨페티 버스트"와 같이 — npx hyperframes catalog --query "<모양을 일반 영어로>" --json을 실행하고 계획이 해당 모양을 어떻게 빌드할지 명명하기 전에 상위 결과를 읽으세요. 검색은 아무것도 설치할 필요가 없습니다: 프로젝트, 사전 add, 계정이 필요 없습니다. 모든 디렉토리에서 호스팅된 전체 레지스트리(~400 블록 및 구성 요소)의 순위를 매기므로 적용됩니다.

Individual skills in this repo

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

courtneymgabrus-star/Video

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.

courtneymgabrus-star/Video

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.

courtneymgabrus-star/Video

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.

courtneymgabrus-star/Video

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.

관련 스킬