비디오 편집 — 자막 쇼케이스 파이프라인
HyperFrames 기반의 엔드-투-엔드 자막 비디오 편집기입니다. 사용자가 비디오를 제공하면 전사 → 검토 → 렌더링 과정을 조율하며, 긴 렌더링 전에 항상 대본 승인을 위해 일시 중지합니다.
YUV.AI 피라미드에서 이 스킬의 위치
video-edit은 yuv-design-system, yuv-decks, yuv-viral-video, parallax-landing-page, video-to-landing-page와 함께 YUV.AI 스킬 피라미드의 중간 계층에 있습니다. 최상위 오케스트레이터인 yuv-pilot은 사용자가 자막이 있는 쇼케이스, 튜토리얼, 또는 자막이 있는 토킹헤드 편집을 원할 때 이곳으로 라우팅합니다.
이것은 yuv-viral-video의 보다 일반적인 비디오 파생 스킬입니다. 차이점은:
yuv-viral-video— 정해진 YUV.AI 바이럴 숏 파이프라인(MrBeast 템포, 시그니처 편집 스타일)video-edit— 대본 검토 후 렌더링하는 일반 자막 편집기(히브리어 + 영어 + 모든 Whisper 언어)
YUV.AI 브랜드 자막 비디오의 경우 이 스킬을 yuv-design-system(타입/팔레트 결정을 위한 네온 모드)과 함께 사용하십시오. 일반/타사 자막 비디오의 경우 이 스킬은 단독으로 작동합니다.
호출 시점
- 비디오 파일(mp4/mov/mkv) 경로 + "편집", "자막", "자막 추가", "릴/프로모션 제작", "동일하게 처리" 요청
- "자막 수정 / 히브리어 맞춤법 오류 수정" — 기존 프로젝트의 검토 단계에서 다시 진입
- 모든 자막 튜토리얼 / 토킹헤드 / 프로모션 제작
저장 위치
기본값: ~/Documents/yuv-projects/videos/<slug>/ — 렌더 결과를 찾을 수 있도록 항상 자막 비디오 프로젝트를 여기에 저장합니다. <slug>는 주제 또는 소스 파일명에서 파생된 짧은 이름입니다.
mkdir -p ~/Documents/yuv-projects/videos
cd ~/Documents/yuv-projects/videos
# 여기서 프로젝트를 초기화합니다.
최종 렌더는 ~/Documents/yuv-projects/videos/<slug>/renders/<name>_FINAL.mp4에 저장됩니다. 렌더가 끝나면 사용자에게 비디오 위치를 알려주십시오.
워크플로우 (12단계)
-
소스 분석 —
ffprobe로 해상도, fps, 길이, 오디오 확인. -
프로젝트 생성 —
cd ~/Documents/yuv-projects/videos && npx hyperframes init <slug> --video <path> --non-interactive. 복사된 비디오 이름을source.mp4로 변경. -
오디오 추출 —
ffmpeg -i source.mp4 -vn -ac 1 -ar 16000 audio.wav. -
전사 —
references/transcribe.py를 프로젝트로 복사. 기본 모델large-v3(히브리어에 가장 좋음). CUDA는 일반적으로 Windows에서 실패(cuDNN 부재); 스크립트는 CPU int8로 폴백. 히브리어는language="he", 영어는language="en"으로 강제 지정; 그 외는 자동 감지. -
알려진 오류 적용 —
references/corrections-hebrew.md내용을 프로젝트 루트의corrections.json으로 복사(키 = 잘못된 토큰, 값 = 올바른 토큰). -
🛑 정지 — 리뷰 서버를 시작하고 사용자가 웹앱에서 승인하도록 합니다. 먼저 알려진 오류를 적용합니다:
references/make_review.py를 프로젝트로 복사하고 실행python make_review.py.transcript.json에corrections.json을 적용합니다.그런 다음 리뷰 서버를 백그라운드 작업으로 실행합니다(사용자가 브라우저에서 "승인 및 렌더"를 클릭할 때까지 차단):
python "$HOME/.claude/skills/video-edit/references/serve_review.py" . # Windows: python "C:\Users\<you>\.claude\skills\video-edit\references\serve_review.py" .서버는
REVIEW_URL=http://localhost:PORT/와 같은 줄을 출력합니다. 백그라운드 작업 출력(또는 stdout 읽기)에서 URL을 가져와 사용자에게 보냅니다:👉 여기서 대본을 검토하세요: http://localhost:PORT/ 승인 및 렌더를 클릭하면 자동으로 계속 진행합니다.
에이전트는 "계속" 메시지가 필요하지 않습니다 — 사용자가 버튼을 클릭하면 서버는
transcript_review.txt를 프로젝트 디렉토리에 쓰고 코드 0으로 종료합니다. 에이전트의 백그라운드 작업 알림이 실행되고 파이프라인이 8단계부터 재개됩니다.브라우저/서버가 없는 경우 폴백: 정적 파일로 편집기를 엽니다 (
start "" "$HOME/.claude/skills/video-edit/transcript-editor/index.html"), 사용자에게 프로젝트 폴더를 선택하고 편집한 후transcript_review.txt를 프로젝트에 저장하고 "계속"이라고 응답하도록 요청합니다. 편집기는 두 모드를 모두 지원합니다. -
(선택 사항) 배경 제거 — 아래 7단계 참조; 사용자 검토와 병렬로 실행 가능.
-
승인 후
python references/apply_review.py를 실행합니다. 편집된 줄을 다시 토큰화하고 단어 타이밍을transcript.json에 재분배하여 캡션 동기화가 여전히 작동하도록 합니다. -
(선택 사항) 배경 제거 — 토킹헤드 세그먼트에 피사체 뒤 텍스트가 필요한 경우
outro.mp4(또는intro.mp4)로 세그먼트를 추출하고npx hyperframes remove-background <clip>.mp4 -o <name>_subject.webm --quality best를 실행합니다. 대부분의 설정에서 CPU 전용(15초 1440p 클립에 약 38분 소요). -
밀집 키프레임으로 소스 재인코딩 — 멀티 워커 렌더는 성긴 키프레임에서 프리즈 현상이 발생합니다. 항상 실행:
ffmpeg -y -i source.mp4 -c:v libx264 -preset medium -crf 18 -r 30 -g 30 -keyint_min 30 -sc_threshold 0 -pix_fmt yuv420p -movflags +faststart -c:a copy footage.mp4 -
(편집된) 대본을 다시 로드하고
references/gen_body.py를 통해 본문 서브 컴포지션을 생성합니다. 생성기는 전체compositions/components/caption-body.html을 내보내며, 에디토리얼과 매트릭스가 번갈아 나타나는 liquid-glass 캡션으로 구성되고 왼쪽 하단 중앙에 고정됩니다(오른쪽 하단 웹캠 PiP 영역을 비움). -
호스트
index.html을references/host-template.html에서 연결합니다. 레이어 순서(z-index, 트랙 인덱스 아님):- z0: 푸티지
.cam-bg - z1: liquid blob 배경(
compositions/liquid-blobs.html,mix-blend-mode: screen, 전체 길이) - z2: 피사체 뒤 자막 패럴랙스(intro 및/또는 outro, 배경 제거 사용 시)
- z3: 피사체 컷아웃
.cam-out/.cam-sub(일치하는data-media-start포함) - z6: 본문 캡션
- z46: 진행 바 + 플래시 + liquid morph 전환 효과
- z0: 푸티지
-
린트 —
npx hyperframes lint. 오류가 0이어야 합니다. 일반적인 수정 사항: 전환 효과 요소의 GSAP/CSS transform 충돌(xPercent/yPercent사용 또는 CSS transform 제거); 동일 속성에 대한 중복 트윈(overwrite: "auto"추가). -
렌더 —
npx hyperframes render --quality standard --fps 30 --output renders/<name>_FINAL.mp4. Standard가 적절한 전달 대상입니다.high는 렌더 시간을 약 두 배로 늘립니다. 완료 보고 전에 타임라인 전체에서 6~8개의 스팟 체크 프레임으로 확인합니다.
TikTok/Reels/Shorts용 세로(9:16) 출력
사용자가 세로/포티트/TikTok/Reels/9:16 출력을 요청할 때(16:9 소스에서):
- 프로젝트를 형제 폴더로 복제:
cp -r project/ project-vertical/. index.html을references/host-template-vertical.html(1080×1920 캔버스, 블러 배경과 liquid blob, 중앙에 16:9 푸티지 가로 스트립, 캡션 아래)로 교체.gen_body.py를references/gen_body_vertical.py(중앙 정렬 캡션, 더 큰 글꼴, 더 좁은 최대 너비)로 교체하고 다시 실행하여compositions/components/caption-body.html을 생성.- 피사체 뒤 컷아웃 + 패럴랙스 서브 컴포지션을 제거(컷아웃은 16:9에 정렬되어 있음, v1에서 재정렬할 가치 없음). 세로 컴포지션은 대신 블러 소스 배경 + blob를 분위기로 사용.
data-duration을 실제 비디오 길이로 업데이트.index.html의 브랜드 칩 텍스트를 업데이트(기본값YUV.AI).- 린트 + 렌더 — 동일한 명령어. 출력은
1080×1920. TikTok/IG Reels/YT Shorts에 바로 업로드.
16:9와 9:16을 한 번에 제공하려면 두 개의 렌더 명령어를 실행합니다(병렬 프로젝트). transcript_review.txt 승인은 둘 다에 적용됨 — 동일한 캡션, 두 개의 컴포지션.
중요 규칙
- 명시적인 대본 승인 없이 최종 렌더를 절대 실행하지 마십시오. 검토 단계가 핵심입니다.
- 히브리어:
large-v3+language="he"+direction: rtl+ Rubik(700 + 900, 편집 이중 가중치 강조용). - 캡션 필은 항상 불투명한 어두운 배경이 필요합니다 — 밝은 텍스트만 있으면 흰색 앱 UI에서 사라집니다.
- 캡션 필을 가로로 중앙 정렬하되 푸티지에 오른쪽 하단 웹캠 PiP가 있는 경우 중앙 x 좌표를 왼쪽으로 이동(예:
left: 720px). - 피사체 뒤 컷아웃 클립은 반드시
data-media-start가data-start와 일치해야 합니다(또는 클립이 추출된 경우 소스의 오프셋과 일치). 그렇지 않으면 컷아웃이 프레임 0부터 재생되어 동기화가 깨집니다. remove-backgroundwebm은 원본 RGB를 유지하고 알파 마스크만 씁니다 —ffprobe는yuv420p를 보고하여 "알파 없음"처럼 보입니다.TAG:ALPHA_MODE=1을 통해 확인하거나 단색 위에 합성하여 확인합니다.- 아웃트로/엔드 카드에 텍스트가 박혀 있는 경우 — 그 위에 캡션을 넣지 마십시오. 충돌합니다.
파일 참조
| 파일 | 목적 |
|---|---|
transcript-editor/index.html | 대화형 브라우저 편집기 — 비디오 미리보기, RTL 편집, 사전 적용, 선택적 WebLLM AI 제안, transcript_review.txt 저장 |
references/setup.md | Node/Python/FFmpeg/faster-whisper용 사전 요구 사항 + 설치 명령어 |
references/transcribe.py | CPU 폴백 + 단어 타임스탬프가 있는 faster-whisper 전사 |
references/serve_review.py | 로컬 리뷰 서버 — 자동으로 편집기 로드, 사용자가 승인 및 렌더를 클릭할 때까지 차단, 그 후 transcript_review.txt를 쓰고 종료(에이전트에 신호 보냄) |
references/make_review.py | 오류 수정 적용 + transcript_review.txt 생성(파일 모드 폴백) |
references/apply_review.py | 편집된 리뷰 파일 파싱, 단어 타이밍 재분배, transcript.json 업데이트 |
references/gen_body.py | 캡션 본문 생성기(에디토리얼 + 매트릭스를 liquid-glass 필에 표시) |
references/host-template.html | 16:9 호스트 컴포지션(액체 효과 + 전환 와이프 포함) |
references/host-template-vertical.html | 9:16 호스트(1080×1920) — TikTok/Reels/Shorts 레이아웃: 블러 배경, 중앙 16:9 푸티지 스트립, 아래 캡션, 오른쪽 상단 브랜드 칩 |
references/gen_body_vertical.py | 세로용으로 조정된 캡션 본문 생성기(중앙 정렬 캡션, 더 큰 글꼴, 더 좁은 최대 너비) |
references/liquid-blobs.html | 전체 길이로 떠다니는 blob 레이어 |
references/caption-parallax-outro.html | 피사체 뒤 캡션 템플릿(영어, 다른 언어는 복제하여 사용) |
references/corrections-hebrew.md | 알려진 히브리어 Whisper 오인식 목록 |
references/transcript-review-workflow.md | 일시 중지/승인 단계 상세 설명 |