Communitygithub.com

general-video

HyperFrames 컴포지션을 처음부터 작성하거나 편집합니다. 짧은 모션 그래픽이나 단일 장면에 적합하지 않은 장편, 다중 장면, 브랜드 릴, 몽타주, 푸티지 리믹스에 사용합니다.

general-video란 무엇인가요?

이 스킬은 HyperFrames 플랫폼에서 비디오 컴포지션을 생성하고 편집하기 위한 범용 워크플로우입니다. 짧은 모션 그래픽 유닛에 최적화된 `motion-graphics` 스킬과 달리 `general-video`는 장편 내레이션, 다중 장면 브랜드 릴, 푸티지 리믹스, 정적 타이틀 카드, 자유 형식 구성 등 더 복잡한 프로젝트를 처리합니다. BRIEF.md에 `flow: companion`이 설정된 경우 협업 모드로 작동하며, 사용자가 크리에이티브 결정을 주도할 수 있게 합니다. 워크플로우는 사용량 확인, 프로젝트 상태 처리(새 생성, 기존 BRIEF.md 재개, 특정 편집), 미디어 어셈블리, 장면 및 전환 애니메이션, 렌더링, 승인 게이트를 포함한 단계별 프로세스를 안내합니다. 이 스킬은 Cursor, Claude Code, Codex.ai와 같은 도구와 통합되어 AI 에이전트가 개발자 워크플로우 내에서 일관된 규칙을 따르며 비디오 프로젝트를 안내하고 조작할 수 있게 합니다. 설치 시 HyperFrames 플러그인 컨텍스트를 존중하며, 미디어 어셈블리, 스토리보드, 생산 루프 등 작업 단계마다 관련 지침을 먼저 로드해야 합니다.

지원 대상~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/maddysjarvisv1/claude-code-video-skills/tree/main/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인 경우에만 여기로 돌아옵니다.

새 프로젝트의 경우 브리프에서 케밥 케이스 디렉토리 이름을 선택하고 브리프를 작성하기 전에 스캐폴드합니다:

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: 계획 및 스케치 검토 실행(storyboard.html). no: 없이 빌드합니다.
파생된 mode체크포인트 게이트 동작 방식브리프 계약을 따릅니다. 사용자에게 모드 이름을 묻지 마십시오.

이러한 상태에 대한 동의어를 만들지 마십시오. 진행 중인 "그냥 빌드" 신호는 의도 레이어에서 처리되며 flow: automation, storyboard: no로 전달됩니다.

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

기존 푸티지의 하드 컷, 트림, 접합 또는 재정렬의 경우 동일한 비디오 소스를 여러 클립 요소로 복제합니다. 각 복사본에서 data-media-start와 data-duration으로 소스 범위를 설정한 다음 data-start로 작성된 배치/순서를 설정합니다. 각 비디오 세그먼트는 사운드를 유지합니다: 사운드는 클립(data-has-audio="true")에 유지되므로 비디오를 자르면 사운드도 잘립니다. /hyperframes-core가 이 시간 편집을 소유합니다. /hyperframes-keyframes는 내부 래퍼에서 줌, 펀치, 팬, 크롭, 마스크 또는 clip-path와 같은 시각적 속성 애니메이션에만 사용합니다. 전체 계약은 ../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개의 블록 및 구성 요소)의 순위를 매기므로 사용자가 빌드 중간에 요청하는 룩에도 적용됩니다. 계획이 명명한 블록은 3단계에서 설치됩니다. 검색 결과에 적합한 것이 없을 때만 룩을 직접 작성합니다. 다중 장면 계획은 디스패치 아티팩트로도 기록됩니다: STORYBOARD.md에 장면당 하나의 ## Frame N 블록 — status: outline, 선언된 src:, 청사진/규칙 인용, 상태(draft, review, final, dropped).

  2. 에셋. 미디어 타임라인을 어셈블합니다. /media-use를 사용하여 모든 미디어 참조를 확인하고 충족시킵니다. 지정된 소스 어댑터를 통해. 운영 제약 조건에 대해 /hyperframes-core → references/variables-and-media.md를 읽습니다.

  3. 구축. 하이퍼프레임스 HTML을 생성합니다. /hyperframes-core → references/composition-patterns.md를 참조하여 적절한 패턴을 선택합니다. 빌드를 진행하기 전에 이전 디자인 사양(있는 경우)에 대한 준수를 /hyperframes-creative → references/design-adherence.md에서 확인합니다. /hyperframes-core → references/determinism-rules.md에서 정의된 대로 레이아웃 결정에 엄격합니다. 각 단계에는 있습니다.`를 유지합니다.

  4. 애니메이션. /hyperframes-animation을 읽고 각각에 대해 일치하는 규칙 또는 청사진을 찾습니다. 명명된 각 장면 모션: 장면 전환, 텍스트 애니메이션, 시각적 효과. /hyperframes-keyframes를 사용하여 개별 속성 애니메이션을 만듭니다. /hyperframes-core → references/determinism-rules.md에 대한 패턴을 따릅니다.

  5. 스토리보드.(선택 사항). 스토리보드가 필요한 경우 ../hyperframes/references/storyboard-format.md를 읽고 ../hyperframes/references/review-loop.md를 따릅니다. 스토리보드 검토를 실행합니다.

  6. 렌더링 및 내보내기. npx hyperframes render <output-dir>을 사용하여 최종 비디오를 렌더링합니다. 렌더링하기 전에 npx hyperframes validate를 실행하여 컴포지션을 검증합니다. 사용자에게 최종 승인을 요청합니다.

계획 규율

다중 장면 계획의 경우 각 장면은 ## Frame N 블록으로 설명됩니다. src: 필드는 장면 유형(stock, ai-gen, screen-capture, upload)을 선언합니다. motion: 필드는 사용된 애니메이션 청사진 또는 규칙을 인용합니다. audio: 필드는 사운드 디자인 요소를 설명합니다. 각 장면에 대해 상태(outline, draft, review, final, dropped)를 추적합니다.

[참고: 원본의 잘린 텍스트는 여기서 복구되었습니다. 나머지 스킬 문서는 계속됩니다.]

Individual skills in this repo

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

관련 스킬