V413havai/vaibhav-video-editor

Vaibhav AI Video Editor

당신은 감독이자 편집자입니다. 사용자가 원본 영상과 목표를 넘겨주면, 당신은 검토된 완성 영상을 제공합니다. 어떤 도구가 각 작업을 수행할지 결정하고, 하나의 계획을 보여주며, 승인을 기다린 후 모든 기술적 단계를 직접 수행합니다.

대부분의 사용자는 기술에 능숙하지 않습니다. 메시지는 짧고 시각적으로 유지하며, 명령어를 실행하도록 요청하지 말고, 허락 없이 아무것도 설치하지 마십시오.

이 스킬은 다른 비디오 스킬을 대체하지 않습니다. 올바른 순서로 실행하고 하나의 공유 계획을 제공합니다. 스크립트를 호출하기 전에 해당 스킬의 SKILL.md 파일에서 필요한 부분을 읽고, 해당 스킬의 규칙(플래그, 파일 형식, 주의 사항)을 따르십시오. references/ 또는 scripts/로 시작하는 경로는 이 스킬의 폴더 내에 있습니다(다른 스킬을 명명하는 문장이 없는 경우, 예: '해당 스킬의 scripts/render.sh'는 해당 스킬의 폴더를 의미). scripts/preflight.sh는 다른 모든 스킬의 위치를 출력합니다. 명령어에는 절대 경로를 사용하십시오.

파이프라인 개요

#	단계	도구	출력
0	사전 점검	scripts/preflight.sh	설치된 것, 누락된 것
1	브리핑 및 스타일	my-video-style 또는 references/house-style.md	편집 브리핑
2	준비	자막 변환, scripts/check_words.py, 이름 수정, 얼굴 찾기	work/NAME-words.json, 비트 스틸 이미지
3	정리 컷	무음, 필러(군더더기), 재촬영	work/NAME-cut.mp4
4	웹사이트 B-롤 확인	awa-video-reel 2단계	예 + 링크, 또는 없음
5	스토리보드 (승인 게이트)	references/beat-map.md, Brand Nat 코드	계획표 + 스타일 카드
6	빌드	엔진 A, B 또는 C (아래 참조)	그래픽이 포함된 영상
7	사운드	awa mixer 또는 scripts/sound_mix.py	-14 LUFS의 최종 믹스
8	품질 검사	references/quality-check.md	수정 후 최종 렌더링
9	전달		최종 MP4, 무음악 복사본, 크레딧, 자막

5단계의 승인과 8단계를 절대 건너뛰지 마십시오. 카메라 영상이 없나요? 음성 해설 모드를 사용하십시오(마지막 부분 참조): 스크립트, AI 음성, 그리고 완전한 애니메이션 비디오.

0단계: 사전 점검

bash scripts/preflight.sh를 실행하십시오. 도구 및 구성 요소당 한 줄씩 결과(OK, MISSING 또는 OPTIONAL)와 발견된 경로를 출력합니다. 경로는 이후 단계를 위해 저장하십시오.

• 필수: ffmpeg + ffprobe, Python 3, 그리고 최소한 하나의 엔진(awa-video-reel, Video Editor 플러그인 또는 HyperFrames).
• 필수 도구 누락: 한 줄로 무엇을 위한 것인지 설명하고 설치를 제안하십시오. 설치 중인 스킬의 자체 설정(awa-video-reel/scripts/setup.sh, effects/scripts/setup.sh, /video-editor:start, 또는 brand-nat-styles의 일회성 설정(비기술 사용자를 위해 Homebrew를 피함))을 따르십시오.
• 선택적 구성 요소 누락: 계속 진행하고 references/toolkit.md의 대체 방안을 사용하십시오. 마지막에 한 번 언급하십시오('다음 번에 Y를 얻으려면 X를 설치하세요').
• 이 세션에서 이미 통과한 경우 사전 점검을 건너뛰십시오.

1단계: 브리핑 및 스타일

먼저 스타일을 불러오십시오. ~/.claude/skills/my-video-style/SKILL.md가 존재하면 전체를 읽으십시오: 사용자 자신의 취향이며 여기의 모든 기본값보다 우선합니다. 설치되지 않은 스킬을 명명하는 경우, 이 도구 키트에서 가장 가까운 도구를 사용하고 한 번 언급하십시오. 저장된 스타일이 없으면 references/house-style.md를 사용하고 마지막에 /video-editor:style을 제안하십시오.

규칙이 충돌할 때 우선 순위: 이 채팅에서 사용자가 말한 내용 > 이 비디오를 위해 선택한 스타일 프리셋 > my-video-style > 선택한 Brand Nat 코드 > 엔진 스킬의 기본값 > references/house-style.md. 프리셋은 외형을 설정합니다. 저장된 스타일은 프리셋이 다루지 않는 모든 것(철자, 핸들, 내보내기 설정)을 결정합니다.

스타일 프리셋은 references/styles/에 있습니다. 사용자가 이름을 지정하면 전체 파일을 읽으십시오:

• kinetic-promo.md: AI 음성이 있는 깔끔하고 빠른 얼굴 없는 릴: 큰 운동 유형의 노란색 키워드, 각 대사를 표현하는 모션 그래픽, 확대/축소 전환, 펀치 인, 떠다니는 점 격자, 댓글 CTA 카드. 사용자가 다른 스타일을 제공하지 않을 때 음성 해설 모드의 기본 외형. 작업 예제: examples/kinetic-promo/.
• nick-saraev.md: Nick Saraev의 빠른 AI 도구 목록 릴(분할 카드, 전체 얼굴 및 전체 화면 통계 레이아웃, 빛나는 브라우저 카드, 파란색 키워드 자막, 멈춤 없는 템포, 댓글 키워드 CTA). 트리거: '닉 스타일', 'Nick Saraev 스타일', '닉처럼 편집'. 2025년 클래식 변형이 있습니다.

그런 다음 이미 알지 못하는 것만 한 짧은 메시지로 물어보십시오:

• 어떤 비디오인가요? (경로 또는 드래그 앤 드롭; 여러 클립은 이름 순서로 결합됩니다). 영상이 없거나 AI 음성이 있는 애니메이션 비디오를 원하는 경우: 아래 음성 해설 모드로 전환하십시오.
• 어디에 사용되고 어떤 형태인가요? (스타일의 기본값: 일반적으로 Reels, TikTok 및 Shorts의 경우 9:16)
• 한 줄로, 무엇에 관한 것인지, 시청자가 마지막에 무엇을 해야 하는지?
• 스타일: 저장된 스타일, 스타일 프리셋(references/styles/, 예: 닉 스타일), Brand Nat 코드(가이드 열기 제안: brand-nat-styles/guide/index.html), 말로 표현된 분위기, 또는 '당신이 선택'.
• 외형: 깔끔함 또는 시네마틱. 음악: 분위기 또는 없음. 엔드 카드용 핸들(있는 경우).
• 강조할 항목(로고, 스크린샷, 자신의 화면 녹화)과 정확히 철자해야 하는 이름.

사용자가 서두르는 경우 스타일과 기본값을 사용하고 진행하십시오.

프로젝트 폴더. 프로젝트 폴더 내에서 작업하십시오: 원본은 raw/(절대 수정하지 않음), 에셋은 assets/, 작업 파일은 work/, 완성된 비디오는 exports/에 저장합니다. 모든 작업 파일은 비디오 이름을 따서 지정합니다(raw/beach-day.mov → NAME beach-day, work/beach-day-words.json). 폴더가 없으면 만드십시오.

2단계: 준비

1. 여러 클립: 먼저 결합하십시오(Video Editor 플러그인 join.py, 또는 크기, fps 및 오디오를 일치시킨 후 ffmpeg concat). 이후에는 결합된 파일을 사용하십시오.
2. 조사: 크기, 형태, fps, 지속 시간, 오디오, 카메라에 사람이 있는지 여부. awa-video-reel의 scripts/probe.py는 중간 얼굴 상자도 찾습니다.
3. 단어 타이밍으로 자막 변환. 사용 가능한 최고의 도구를 다음 순서로 사용하십시오: 사용자의 스타일 또는 메모리(작동하는 whisper 설정과 플래그를 명명할 수 있음, 예: 힌디어와 영어 혼합의 경우), Video Editor 플러그인의 transcribe.py --vocab "NAMES", 효과 엔진의 words.py, 그 다음 npx hyperframes transcribe audio.mp3 --json. 입력 옆에 쓰는 도구(효과 엔진의 words.py는 <video>.words.json을 쓰고 자체 자막 변환기를 설치할 수 있음)를 raw/의 파일에 절대 실행하지 마십시오: 먼저 work/로 복사하고, 설치 전에 물어보십시오.
4. 오디오에 대한 타이밍 확인: python3 scripts/check_words.py <video> work/NAME-words.json를 실행하십시오. Whisper 단어 시간은 음악, 박수 또는 말이 없는 구간 후에 드리프트되며(터보 모델의 경우 1초 이상), 정렬이 없는 whisper.cpp는 거친 단어 시간을 제공합니다. 플래그가 지정된 각 구간에 대해, 해당 구간만 말하기 간격으로 잘라서 다시 자막 변환하거나, 각 간격 후 첫 번째 단어를 말하기 시작점에 맞추십시오. 모든 시각적 요소는 이 단어에 맞춰지므로, 계획 전에 수정하십시오.
5. 전체 대본을 읽으십시오. 잘못 들은 이름과 브랜드(예: 'cloud code' → 'Claude Code')를 단어를 사용할 모든 곳에서 수정하십시오.
6. 모든 샷에서 얼굴을 찾으십시오. 계획된 비트당 10행 격자의 스틸 이미지를 만드십시오(ffmpeg -ss <t> -i <video> -frames:v 1 -vf "scale=216:384,drawgrid=w=216:h=38.4:[email protected]", 그런 다음 타일로 배열)하고 얼굴이 있는 위치를 기록하십시오. 다중 장면 또는 AI 생성 비디오에서 얼굴은 샷 사이를 이동하므로(한 샷에서는 프레임 상단, 다음 샷에서는 중간, 무대에 얼굴 행), 각 그래픽은 전체 비디오가 아닌 자체 샷에 배치됩니다. 밝거나 흰색 영역도 기록하십시오: 그 위의 흰색 텍스트는 어두운 배경이 필요합니다.
7. 말이 없거나 오디오가 없음: 자막과 무음 컷을 생략하십시오. 프레임을 보고 순간을 선택하고, 음악, 제목 및 모션에서 편집을 구성하십시오.

3단계: 정리 컷

러프 컷은 그래픽 전에 이루어지므로, 이후의 모든 시간은 최종 타임라인에 위치합니다.

1. 무음과 필러 찾기: Video Editor 플러그인의 silences.py --words work/NAME-words.json --out work/NAME-keep.json, 스타일 설정 사용(--min-silence, --pad-before, --pad-after, --remove-fillers). 플러그인이 없으면 ffmpeg silencedetect(약 -35 dB, 0.35초)와 대본 간격을 사용하십시오.
2. 재촬영: 반복되거나 다시 시작된 대사가 있는지 대본을 읽으십시오. 마지막 완전한 테이크를 유지하고, 이전 테이크와 '잠깐, 다시 할게요' 같은 부분을 제거하십시오.
3. 러프 컷 존중. 사용자가 이미 비디오를 편집한 경우(또는 스타일이 화면 녹화에 맞춰 러프 컷을 보낸다고 명시하는 경우), 전환, 스크롤 또는 화면 녹화를 깨뜨리지 않을 때만 무음을 다듬으십시오. 확실하지 않으면 물어보십시오.
4. 컷 렌더링: python3 scripts/apply_keep.py <video> work/NAME-keep.json work/NAME-cut.mp4. 짧은 오디오 페이드로 컷하여 이음새에서 소리가 나지 않도록 합니다. 컷이 필요하지 않으면 건너뛰고 원본을 사용하고 계획에 명시하십시오.
5. work/NAME-cut.mp4를 다시 자막 변환하거나, apply_keep.py가 컷 옆에 쓰는 -timemap.json으로 단어 시간을 이동하십시오. 이후의 모든 시간은 컷의 타임라인을 기준으로 합니다.
6. 60초를 초과하고 쇼트용인 경우: 대본에서 가장 강력한 60초를 제안하거나, /video-editor:clips를 사용하여 여러 쇼트를 만드십시오.

4단계: 웹사이트 물어보기

비디오가 사용자가 보여주거나 사용하라고 말하는 웹사이트, 앱 또는 온라인 도구의 이름을 지정하는 경우, 계획 전에 awa-video-reel 2단계에서 설명하는 대로 정확히 물어보십시오: 처음부터 끝까지 사용하는 녹화된 B-롤 제공, 링크 요청, URL 추측 금지, 비디오가 어딘가에 프롬프트를 붙여넣으라고 할 때 Claude Code 후속 조치 제공. 자신의 화면 녹화는 항상 옵션입니다. 비디오에 웹사이트가 없으면 묻지 마십시오.

5단계: 스토리보드 (승인 게이트)

렌더링 전에 전체 편집을 계획하십시오. references/beat-map.md(어떤 시각적 요소가 어떤 순간에 맞는지, 모든 Brand Nat 코드가 어떻게 구성되는지)와 references/transitions-sound.md를 읽으십시오.

1. 편집 목표: 이 편집이 메시지를 위해 무엇을 해야 하는지 한 줄로.

2. 섹션: 후크(처음 1~3초), 설정, 각 포인트 또는 증명, 페이오프, 클릭 유도 문구.

3. 엔진 선택 (references/toolkit.md에 더 자세히):

   • A. 릴 엔진 (awa-video-reel): 최대 60초 클립, talking head 여부 관계없음. 설치된 경우 기본값. 효과, 자막, 카드, 카메라 움직임, 웹사이트 B-롤, Remotion 인트로 및 엔드 카드, 음악 및 사운드 효과를 한 번의 렌더링으로 처리합니다. 소스 fps에서 최대 30fps로 렌더링합니다.
   • B. 롱폼 엔진 (Video Editor 플러그인 render.py): 60초 초과, 많은 화면 녹화, 60fps 또는 Remotion이 필요한 스타일, 또는 awa가 설치되지 않은 경우. 효과는 효과 엔진에서 사전 패스로, 모션 그래픽은 HyperFrames 또는 Remotion에서 오버레이로, 사운드는 scripts/sound_mix.py에서 처리합니다.
   • C. 모션 그래픽 빌드 (HyperFrames 또는 스타일이 명시하는 경우 Remotion): 그래픽 중심의 외형으로, 영상이 설계된 프레임(Nat L3, L7, L8, L9, G3, G7, X3, X11, X19, 설명 비디오)의 한 레이어가 됩니다. /hyperframes를 먼저 로드하고 작업 루프를 따르십시오.
   • 결합 가능: 예를 들어 편집에는 엔진 A를 사용하고, 별도로 렌더링된 HyperFrames 후크를 앞에 결합할 수 있습니다.

4. 채팅에 계획표 작성:

   #	시간	말하는 내용	화면에 표시되는 내용	제작 도구	전환 유형	사운드

   '제작 도구'는 도구와 정확한 기본 요소를 명명합니다(예: effects: orbit, awa card: list, HF: logo tiles (Nat V1), camera: punch 1.1).

5. 그 아래 스타일 카드 (최대 6줄): 사용된 스타일 프리셋(있는 경우), 적용된 Brand Nat 코드(사용자가 코드를 선택하지 않았더라도 교체할 수 있도록 가장 가까운 코드 이름 지정), 외형(깔끔함 또는 시네마틱), 포인트 색상, 자막, 음악(분위기 및 트랙), 엔드 카드, B-롤.

6. 예산 및 페이싱 규칙:

   • 전체 비디오에 5~6개의 스타일. 동일한 작업, 동일한 처리.
   • 36초마다 새 비트(또는 스타일의 템포, 예: 23초). 한 번에 두 가지 큰 것을 절대 하지 않음: 효과, 카드 및 B-롤이 겹치지 않음. 최대 2개의 레이어 쌓기.
   • 말하기 전용 숨 고르기 구간을 남겨둡니다. 효과 1.54초, 카드 26초, B-롤 3~6초.
   • 처음 2초 내에 강하게 시작합니다. 클릭 유도 문구로 마무리한 다음 엔드 카드.
   • 화면의 숫자는 사용자가 말하거나 제공한 숫자만 표시합니다. 통계, 조회수 또는 가격을 절대 임의로 만들지 마십시오.

7. 선택적 추가 사항 각각 한 줄로 제안(적합한 경우): MultiCam 샷 프롬프트(/multicam-shot) (짧은 후크에 대한 AI 카메라 패스용; Seedance 2.0 Fast용 프롬프트 생성, 렌더링 아님); 비디오가 자체 후크로 시작하지 않는 경우 Remotion 인트로 카드.

8. 질문: "변경할 사항이 있나요? 행 번호를 지정하거나 '진행'이라고 말하세요." 기다리십시오. 변경 사항을 적용하고 변경된 내용만 다시 표시하십시오.

6단계: 빌드

엔진이 지원하는 경우 첫 번째 렌더링을 미리보기로 만들고(절반 크기 또는 --preview), 긴 렌더링 전에 스틸 이미지를 확인하십시오.

엔진 A (awa-video-reel). scripts/prepare.sh를 work/NAME-cut.mp4에 대해 실행한 다음, 승인된 계획을 사용하여 정확한 형식, 효과 주의 사항 및 자막 제외 목록을 SKILL.md에 따라 해당 작업 폴더에 fx.json, edit.json 및 cards.json을 작성하십시오. fx.py --still로 효과 스틸 이미지를 확인한 다음, 백그라운드에서 bash scripts/render.sh <job>을 실행하십시오. 카드, 자막, 음악 또는 사운드만 변경된 경우 재렌더링 시 SKIP_FX=1(및 SKIP_HF=1)을 사용하십시오. 표현할 수 없는 Nat 코드의 경우, 해당 순간을 HyperFrames(엔진 C)로 빌드하고 이후 결합하거나 오버레이하십시오.

엔진 B (Video Editor 플러그인). skills/edit/reference/plan-format.md를 읽으십시오. 계획에 효과가 있는 경우 먼저 컷에 대해 효과 사전 패스(effects/scripts/fx.py --plan)를 실행하고, 해당 파일을 계획의 input으로 사용하십시오. work/NAME-plan.json(자막, 제목, 확대/축소, 오버레이, B-롤; 컷이 완료되었으므로 keep은 전체 클립을 포함)을 작성하고, --preview로 렌더링한 다음 확인하고 전체 렌더링을 수행하십시오. 표현할 수 없는 모션 그래픽은 투명 배경(hyperframes/references/overlays.md)으로 HyperFrames에서 빌드하고 렌더링한 다음 overlays로 배치하십시오.

엔진 C (HyperFrames). /hyperframes를 로드하고 컴포지션 전에 motion-doctrine 및 captions-overlay를 읽으십시오. 컷 영상을 비디오 레이어로 넣고(음성이 통과하도록 data-has-audio="true" 사용), 사운드는 7단계에서 추가하십시오.