Communitygithub.com

다중 동영상 변형 (multi-video-variants)

승인된 마스터 동영상 하나를 다양한 종횡비(9:16, 1:1 등), 후크 변형, 플랫폼 버전, 무음/무자막 버전 등 여러 출력물로 변환합니다. 엄격한 파일명 규칙, 공유 믹스, 만료된 파생물을 차단하는 매니페스트를 통해 제어를 유지합니다.

다중 동영상 변형 (multi-video-variants)란 무엇인가요?

이 스킬은 하나의 승인된 마스터 동영상에서 여러 개의 파생 출력물을 체계적으로 생성하는 워크플로우를 제공합니다. 주 사용 사례는 동영상 마케팅 및 소셜 미디어 콘텐츠 제작으로, 동일한 콘텐츠를 다양한 플랫폼(메타, 틱톡, 유튜브 등)과 종횡비(9:16, 4:5, 1:1, 16:9) 및 후크 변형(예: 후크A, 후크A-무음)으로 제공해야 할 때 유용합니다. 핵심 원칙은 다음과 같습니다: 마스터 동영상이 완전한 QA를 통과한 후에만 파생물을 생성하고(마스터 고정), 각 종횡비는 마스터 소스를 다시 레이아웃(크롭 금지)하며, 모든 파생물은 동일한 공유 오디오 믹스를 사용하고(별도 명시 제외), 한 번에 하나의 무거운 작업(렌더 등)만 실행합니다. 각 파생물의 QA, 엄격한 파일명 규칙(예: `{name}_{platform}_{hook}_{aspect}.mp4`), 그리고 최종 파일의 무결성을 보장하는 매니페스트(`manifest_check.py`)를 통해 상태를 추적합니다. 이 스킬은 마스터 디자인(타입 스킬)이나 개별 파일 QA(`render-qa-deliver`)를 대체하지 않습니다. 주로 Claude Code, Cursor, Codex와 같은 AI 에이전트 플랫폼에서 사용되며, 정확성과 제어를 중시하는 동영상 제작 워크플로우에 적합합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Malik-rgb43/editing-workflow/tree/HEAD/.agents/skills/multi-video-variants

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

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

문서

다중 동영상 변형 (multi-video-variants)은(는) 무엇을 하나요?

승인된 마스터 하나를 N개의 출력물로 변환하며, 어떤 파일이 어떤 소스 상태에서 왔는지 추적 제어를 유지합니다. 이 스킬은 변형 매트릭스, 마스터 고정, 재레이아웃 복사본, 공유 믹스, 파일명, 한 번에 하나씩 렌더링하는 대기열, 에이전트 감독 규칙, 그리고 매니페스트 게이트를 소유합니다. 마스터를 디자인하지 않으며(타입 스킬이 담당), 개별 파일 QA(render-qa-deliver)를 대체하지 않습니다.

이 파일의 다른 모든 규칙보다 우선하는 규칙

  1. 마스터 우선, 그 다음 고정. 파생물은 자체 전체 QA를 통과하고 manifest_check.py freeze로 기록된 마스터로만 만들어집니다. 나중에 수정이 필요하면 마스터에서 수정하고 change로 기록한 뒤, 같은 라운드의 모든 복사본에 적용하며, 모든 파생물을 다시 렌더링하고 다시 기록합니다. 복사본만 수정하는 것은 금지됩니다.
  2. 재레이아웃, 절대 크롭 금지. 각 종횡비는 마스터 소스의 복사본(hf_9x16/, hf_1x1/ ...)이며, 자체 캔버스, 안전 영역, 타입 스케일, 자막 레일, 카메라 키, 얼굴 중앙 정렬을 가집니다. 렌더링된 마스터를 FFmpeg으로 크롭하거나 스케일하는 것은 변형이 아닙니다.
  3. 하나의 믹스. 재레이아웃과 후크 변형은 동일한 cues.js와 동일한 assets/mix.wav 바이트를 사용하며, 해당 파일 하나에서 먹싱됩니다. 오디오는 변형별로 재구축되지 않습니다. 자체 믹스가 정말로 필요한 변형(무음, 자체 음성 해설, 재컷 길이)은 매니페스트에 이유를 명시하여 선언합니다.
  4. 전체 머신에서 한 번에 하나의 무거운 작업(렌더, check, 매트, ASR, Blender)은 render_lock 하에 실행합니다. 병렬 작업은 무겁지 않은 작업(레이아웃, 사양, QA 읽기)으로 제한됩니다. 최대 4개의 에이전트가 병렬로 실행되며, 각 에이전트는 최대 2개의 하위 에이전트를 가집니다.
  5. "준비 완료"는 계산되며, 주장되지 않습니다. 이 단어는 manifest_check.py check가 0으로 종료될 때만 사용할 수 있습니다. 시간 초과, 빈 폴더, 해시 누락, qa: not_run 또는 증거 누락은 차단됨 / 증거불충분이며, 절대 통과가 아닙니다.
  6. paid-generation-gate 없이 유료 작업을 수행하지 않으며, 다른 Claude 세션에 메시지를 보내지 않습니다. 사용자 및 프로젝트 제한이 이 절차보다 우선합니다. 안전 영역, -14 LUFS 및 캔버스는 하우스 프리셋 v1(결정 기본값 Q5)이며, 플랫폼 법칙이 아닙니다.

입력 -> 출력

입력: 승인된 마스터(hf/, PROMPT.md, DESIGN.md, cues.js, assets/mix.wav) 및 인테이크의 변형 매트릭스. 출력: final/<name>_<platform>_<hook>_<aspect>.mp4 x N개, final/manifest.json(최종 파일 + 매니페스트만), _work/qa/<aspect>/<round>/ 아래의 파일별 QA 보고서, _work/agents/<agent>.progress.md, _work/STATE.md(대기열). 파일명: <name>_<platform>_<hook>_<aspect>.mp4, <name>은 소문자 ASCII 슬러그(밑줄 허용), <platform> = meta|tiktok|yt|ig|linkedin|x|all, <hook> = master | hookA | hookA-nomusic | hookA-nocaps, <aspect> = 9x16|4x5|1x1|16x9. 또한 다음 약식 비율 형식도 허용됩니다: <name>_<aspect>.mp4(플랫폼 all, 후크 master, 전달 플레이북에서와 같이). 사용자가 원장에서 요청한 이름은 관례를 무시하고 원장 ID와 함께 기록됩니다(record --name-ledger-id).

절차

#단계수행 작업산출물
0인테이크 매트릭스파일당 하나의 원장 행: 종횡비, 플랫폼, 경로(유기적 / 광고 / 스파크), 후크, 버전(전체, 무음, 무자막, 길이), 마스터 종횡비. 늦은 "아마도" 비율: 지금 레이아웃 노트를 작성하여 늦은 요청이 재구축 없이 하나의 에이전트로 처리되도록 함(references/variant-matrix-and-layout.md)PROMPT.md <inputs>의 매트릭스; 매니페스트의 matrix 목록
1마스터 게이트마스터 승인됨, render-qa-deliver 전체 프레임 QA 통과, manifest_check.py freeze <project> --hf hf --matrix ...고정된 src_hash + mix_sha256
2재레이아웃 복사본종횡비당 하나의 에이전트가 복사본에서 작업; 동일한 큐와 믹스 사용; 레이아웃 테이블 작성(요소별 변경 사항, references/variant-matrix-and-layout.md); 프리플라이트 0 오류; 후크, 오퍼, 엔드 카드에서 스냅샷 오버레이(--describe false, 호출당 최대 5개 타임스탬프)hf_<aspect>/, _work/qa/<aspect>/layout.md
3후크 / 버전 변형후크 = 종횡비 복사본의 변수에 바인딩된 하위 구성, 변형당 하나의 행; 먼저 하나의 변형을 테스트(배치 변수는 프로젝트에서 테스트되지 않음); 공유 믹스 먹싱; 무음/무자막 = 선언된 믹스 또는 레이어 변형rows.json, 변형 파일
4대기열_work/STATE.md에 렌더 순서 작성(마스터, 각 종횡비, 변형 순); 각 렌더 전에 manifest_check.py stamp; hf_deliver / render_lock run을 통해 한 번에 하나씩 렌더링; 렌더 소유자는 두 번째 무거운 작업을 시작하지 않음잠금 로그, 스탬프
5기록각 렌더 후: record(해시, 적용된 마스터 수정, 믹스 변형, QA 상태, 최종 파일에서 측정된 음량)manifest.json
6출력별 QAframe_qa, caption_qa --band <top>:1450 (9:16), motion_qa(레이아웃이 모션을 변경한 경우), face_center audit(화자 푸티지), qa delivery; 시각 검토 축 1(구성/크롭) 및 4(가독성)만; 축 2-3은 모션이 변경되지 않는 한 상속됨보고서 + 증거 경로
7준비 게이트manifest_check.py check <project> --json이 0으로 종료됨; 사용자에게 소스 해시, QA 상태, LUFS/TP와 함께 파일 목록 표시; 격차를 정직하게 나열준비 완료 보고서
8학습파일당 타이밍 원장 라인, 받은 편지함에 대한 교훈_work/timing_ledger.jsonl

게이트

상태는 통과 | 실패 | 차단됨 | 해당 없음이며 이유가 포함됩니다. 시간 초과, 빈 샘플 또는 누락된 입력은 차단됨이며, 절대 통과가 아닙니다. 성공적인 도구 호출은 실행 증거이고, 본 렌더는 외관 증거입니다.

게이트조건증거거짓인 경우소유자재확인 시점
G1 매트릭스모든 출력이 빌드 전에 원장 행(종횡비, 플랫폼, 경로, 후크, 버전)을 가짐PROMPT.md 및 매니페스트의 matrix지금 누락된 축을 요청; 빌드하지 않음이 스킬 + video-intake새로운 비율/변형 요청 시
G2 마스터 고정마스터가 전체 QA 통과; freeze 기록됨; 이전에 시작된 파생물 없음매니페스트 master.src_hash, frozen_utc가 모든 스탬프보다 오래됨파생물 중단; 고정이 스킬마스터 소스 변경 시
G3 재레이아웃각 파생물이 자체 루트 캔버스, 요소별 레이아웃 행, 자체 종횡비의 안전 영역을 가짐; 크롭된 마스터 렌더 없음layout.md 행 + 오버레이 스냅샷 + 프리플라이트 0 오류실패한 요소를 재레이아웃; 전체 프레임을 스케일하지 않음종횡비의 에이전트마스터 레이아웃 변경, 새 복사본
G4 공유 자산모든 재레이아웃/후크 복사본에서 cues.* 및 assets/mix.wav가 마스터와 동일함; 후크 변형은 먹싱, 재믹싱 아님manifest_check.py check: M035/M041 없음마스터 큐/믹스를 다시 복사; 재렌더링이 스킬마스터 큐 또는 믹스 변경
G5 출력별 QA각 파일 qa: pass이며 증거 파일 및 최종 파일의 LUFS -14 +/- 0.5, TP <= -1 (하우스 게이트)매니페스트의 qa_evidence 경로, lufs, tp 숫자해당 파일만 수정 및 재렌더링render-qa-deliver재렌더링 시
G6 무거운 작업 규율정확히 한 번에 하나의 무거운 작업; <= 4개 에이전트, 각각 <= 2개 하위 에이전트, 각각 파일 목록, 출력 파일, 마감일, 진행 파일 보유render_lock 로그; _work/agents/*.progress.md mtime대기열에 추가, 추가 작업 중단(자체 프로세스 트리만)이 스킬각 에이전트 시작 시
G7 매니페스트 준비오래된 / 고아 / 누락 / 렌더 후 변경 모두 없음manifest_check.py check 종료 코드 0사용자에게 실패 파일 나열; 오래된 파일 재렌더링manifest_check.py"준비"라고 말하기 전, 변경 후

수치 (하우스 프리셋 v1, 2026-10-02 날짜, 세부 사항은 references/house-presets.md)

  • 캔버스: 9:16 1080x1920, 4:5 1080x1350, 1:1 1080x1080, 16:9 1920x1080; H.264 SDR yuv420p, AAC 48 kHz, 30 fps 기본값.
  • 안전 영역, 주요 텍스트/CTA/로고/가격: 9:16 상단 300 / 하단 672 (y <= 1248) / 왼쪽 140 / 오른쪽 192, 자막 레일 하단 <= y 1450; 16:9 x <= 1824, 상단 54, 하단 162; 4:5 및 1:1 각 측면 54px. 기기에서 확인되지 않음: 오버레이 연습 실행.
  • 음량: -14 LUFS 통합 +/- 0.5, 트루 피크 <= -1 dBTP, 최종 파일에서 측정; 믹스 중간 TP <= -1.5.
  • 감독: 약 15분마다 하트비트 확인; 20분 동안 응답 없거나 마감일 초과 = 확인, 대체 또는 중지; 약 10분의 침묵마다 사용자에게 상태 줄; 렌더 타임아웃은 측정된 ETA의 3배. (출처: distilled 02 workflow §13.6, 2026-10-01)

결정 규칙

경우그렇다면
파생물이 존재한 후 마스터 수정이 필요한 경우마스터를 수정하고, change로 기록하고, 패치를 모든 복사본에 적용하고, 모두 재렌더링 및 재기록
복사본에 다른 타이밍이나 큐가 필요한 경우이는 마스터 변경 사항임; 또는 자체 원장 라인이 있는 새로운 편집(재컷)이며, 절대 조용한 포크가 아님
후크에 다른 음성 대사가 필요한 경우이유와 함께 own-vo를 선언; 다른 모든 변형은 공유 믹스 유지
비율이 늦게 요청된 경우레이아웃 테이블을 작성하고, 고정된 마스터의 복사본에서 하나의 에이전트를 시작; 마스터를 건드리지 않음
두 개의 렌더가 동시에 요청된 경우대기열에 추가; 잠금이 결정; STATE.md에 순서 작성
에이전트가 마감일까지 응답이 없는 경우진행 파일을 확인한 다음, 대체하거나 중지(자체 프로세스 트리만), 그런 다음 render_lock status
최종 폴더에 이전 렌더가 있는 경우_work/delivered/v<N>/로 이동; "준비"는 폴더가 매니페스트와 일치할 때까지 차단됨
사용자가 파일 이름을 지정하는 경우사용자 이름이 우선; --name-ledger-id로 기록하고 platform/hook/aspect 필드를 명시적으로 유지

차단된 상태 (보고하고, 우회하지 마십시오)

manifest_check.py 차단됨 또는 증거불충분; from_master가 오래되었거나 마스터 수정이 누락된 파생물; 렌더 후 변경된 소스; 공유 큐 또는 믹스 드리프트; qa가 통과가 아님; 약속된 변형 누락; 계획되지 않은 파일 존재. 어떤 파일, 어떤 코드, 수정 방법을 말하십시오.

각각 실제 시간을 소모하는 함정

늦은 16:9 요청(전체 재레이아웃, 드롭됨); 3.7초 마스터 수정이 1:1에 적용되지 않음; 이전 렌더가 새 렌더 옆에 남아 있고 아무도 표시하지 않음; 마스터 버그를 발견하고 복사본만 수정한 파생물 에이전트; 세 개의 에이전트가 동시에 렌더링(병렬 Blender 작업이 렌더를 두 배로 늘림, 11.5분에서 21.5분, 소유자 노트북); 메타와 틱톡 컷 간의 이름 충돌; 하나의 후크 변형이 조용히 다른 믹스를 운반함. 각 종횡비의 본 연락처 시트는 여전히 필요함: 해시는 얼굴 위의 자막을 볼 수 없음.

참조 (다음 경우 로드)

  • references/variant-matrix-and-layout.md - 매트릭스 작성, 종횡비 재레이아웃, 후크/무음/무자막/길이 변형.
  • references/manifest-schema.md - 파일 기록, manifest_check.py 결과 읽기, 오래된 파생물 수명 주기.
  • references/parallel-and-agents.md - 에이전트 실행, 대기열, 잠금, 하트비트, 중지, 토큰 예산.
  • references/house-presets.md - 캔버스, 안전 영역, 음량 또는 플랫폼 번호를 인용하기 전에 (날짜가 있는 모듈).
  • agent-content/references/platform-specs.md (표준 플랫폼 사실, 다른 곳에서 소유) 및 agent-content/playbooks/wf-08-deliver.md (전달 플레이북: 파일명, 매니페스트 규칙) - 내보내기 프리셋 및 플레이북; 숫자가 다르면 표준 파일이 우선하고 references/house-presets.md가 업데이트됩니다.
  • 기타 스킬: render-qa-deliver (파일별 QA), hebrew-captions-asr (자막 레일), edit-ad-promo (후크 순위), revision-round (종횡비 간 노트), paid-generation-gate.
  • 스크립트: scripts/manifest_check.py (--self-check 29개 케이스, 종료 코드 0 준비 완료 / 1 차단됨 / 2 증거불충분) 및 scripts/test_manifest_check.py (단위 테스트).

Individual skills in this repo

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

Malik-rgb43/editing-workflow

>- Script, edit or review a paid-social ad, sponsored post or brand promo for a business, product, app or store (Meta, Instagram, TikTok, 15-60 s): exact offer and CTA, ranked hooks, hook variants, end card, blocking compliance table, licence checks. Triggers: ad, promo, sponsored, campaign; מודעה, פרסומת, קמפיין, ממומן, פרומו, מבצע, הנחה, הוק. NOT for testimonials (edit-testimonial), organic expert reels (edit-talking-head), AI-only films (edit-ai-generated), ratio exports (multi-video-variants).

Malik-rgb43/editing-workflow

>- Design, build and review a motion-graphics piece in HyperFrames/GSAP: product or app launch, feature announcement, kinetic typography, logo reveal, UI explainer, animated screenshots. Triggers: מושן גרפיקס, אנימציה, השקה, טיפוגרפיה קינטית, לוגו אנימציה, "like a Higgsfield / Linear launch". Not for a speaker-to-camera reel (edit-talking-head), AI-generated shots (edit-ai-generated), caption-only work (hebrew-captions-asr) or ad compliance (edit-ad-promo).

Malik-rgb43/editing-workflow

>- Transcribe Hebrew speech and build burned-in Hebrew captions: ASR route per hardware, word timestamps, proofreading, RTL and mixed English/number lines, caption font, entrance and exit animation, safe zone, caption QA. Triggers: תמלול, תמלל, כתוביות, כתוביות בעברית, מילים בולטות, קריוקי, המילה יצאה לא נכון, Hebrew captions, transcribe Hebrew, word timestamps, ו/ז look-alike. NOT for translation-only, non-Hebrew ASR, analysis reports (video-analysis), or caption-free motion launches.

Malik-rgb43/editing-workflow

>- Turn a video the user sends or links (file, or YouTube/TikTok/Instagram URL) or a folder of clips into measurements (cuts, pacing, per-frame data), keyframe sheets, a Hebrew transcript and sound analysis (SFX, BPM, key, beats, song ID). Triggers: watch, analyse, break down, transcribe this video/reel/ad; תנתח, תעבור על, תמלל, מה קורה בסרטון, קאטים, BPM. NOT for cutting or rendering (type skills), applying a style (reference-style-transfer), or captions for a final render (hebrew-captions-asr).

Malik-rgb43/editing-workflow

Turn a new video idea, brief or list of specifics into a checkable Concept Ledger and ask questions until every parameter is precise, before any concept, prompt or build. Use at the start of any new video, with or without footage, or when the user pastes a concept with specifics. Hebrew - סרטון חדש, בריף, יש לי רעיון, קונספט, תכין לי סרטון, בוא נתחיל פרויקט. NOT for notes on an existing draft (revision-round), analysing a reference (video-analysis) or paid generation (paid-generation-gate).

관련 스킬