learnaiwithhugo/video-editor-skills

/new-edit-style

참고 영상(reel)을 입력하면 잠금 처리된 /<style>-edit 스킬이 출력되어, 이후 모든 편집이 참고 영상처럼 보입니다. 이는 /kallaway-edit를 구축하고 다듬은 프로세스입니다. 사용자는 일반적으로 기술에 능숙하지 않습니다: 평범한 영어, 단계당 하나의 짧은 메시지, 절대 코드를 만지게 하지 마세요.

SK = ${CLAUDE_SKILL_DIR}, 이 스킬의 폴더. ENGINE = ${CLAUDE_SKILL_DIR}/../kallaway-edit, 검증된 편집 스킬(셋업 마법사, 자막, 컷팅, 컷아웃, 사운드, 빌드, 렌더링, QA를 포함). 절대 SK나 ENGINE에 쓰지 마세요: 업데이트 시 둘 다 교체됩니다. DATA = $HOME/.claude-video-editor, 업데이트에도 유지되는 편집기 폴더(설정, Python, 음향 효과, 폰트 캐시). ROOT = 프로젝트 폴더(DATA/config.json의 projectRoot). 모든 스크립트는 다음 중 하나로 정확히 실행하여 사용자 설정을 찾을 수 있게 하세요: PY = VIDEO_EDITOR_DATA="$HOME/.claude-video-editor" "$HOME/.claude-video-editor/venv/bin/python" -I SYS = VIDEO_EDITOR_DATA="$HOME/.claude-video-editor" python3 -I (셋업 전) STYLE = 짧은 케밥-케이스 이름 ("kallaway"). SDIR = ROOT/references/<STYLE>/. WORK = ROOT/work/new-edit-style/<STYLE>/ (진행 PNG는 WORK/progress/에 번호를 붙여 저장).

엄격한 규칙

• 무료 도구만 사용 (ffmpeg, Python, faster-whisper, HyperFrames, OFL 폰트). 유료 API, 로그인 금지. 참고 링크는 로그아웃 상태로 다운로드 (yt-dlp --no-cookies); 절대 브라우저 쿠키 사용하지 마세요.
• 사용자의 원본 파일에 절대 손대지 마세요; 아무것도 삭제하지 마세요 (이전 버전은 ROOT/archive/로 이동).
• 절대 npx hyperframes init 또는 npx hyperframes skills를 실행하지 마세요; ~/.claude/skills나 ~/.agents/skills에 아무것도 추가하면 안 됩니다.
• 절대 추측을 측정값으로 제시하거나 소리를 들었다고 말하지 마세요. 에이전트는 들을 수 없으며, 사용자의 귀 확인이 결정합니다.
• 편집 STYLE을 복사하는 것은 괜찮습니다; 절대 제작자의 영상, 로고, 음악, 텍스트를 편집에 복사하지 마세요.
• 하위 에이전트: 참고 영상 분석 시 영상당 하나 (Sonnet으로 충분), 동시에 최대 3개, references/breakdown-brief.md로 브리핑. 판단이나 눈이 필요한 것은 직접 하세요.

워크플로우

0. 셋업 (처음 한 번만)

DATA/config.json에 "setupComplete": true가 없으면 편집기 셋업 마법사를 먼저 실행: kallaway-edit 스킬을 setup으로 호출 (또는 ENGINE/SKILL.md 0단계 읽기, ${CLAUDE_SKILL_DIR}은 ENGINE, $HOME/.claude-video-editor은 DATA를 의미): Claude Code 확인, 도구 확인, 프로젝트 폴더, 설치. ENGINE이 없으면 말하세요: "이 작업은 옆에 kallaway-edit 스킬이 설치되어 있어야 합니다 (편집 엔진을 포함). 둘 다 https://github.com/learnaiwithhugo/video-editor-skills 에서 다시 설치한 후 /new-edit-style을 다시 실행하세요." 그런 다음 중단. 이 스킬은 yt-dlp도 필요하므로 (참고 영상 다운로드), 항상 SYS "ENGINE/scripts/setup.py" --check --for new-edit-style로 확인하세요, 첫 실행 및 이후에도. yt-dlp가 없으면 사용자에게 수정 명령을 알려주고 (brew install yt-dlp를 터미널에 붙여넣기), 완료했다고 말할 때까지 기다린 후 다시 확인하세요.

1. 인테이크 (~2분)

한 메시지로 물으세요: "편집 스타일을 복사하려는 한 제작자의 영상 2~3개 (링크 또는 파일), 가능하면 가장 마음에 드는 편집본, 그리고 스타일의 짧은 이름을 보내주세요." 3개가 가장 좋습니다: 규칙은 모두가 공유하는 것에서 나옵니다. 그런 다음: SYS "SK/scripts/fetch.py" STYLE "ROOT" <link 또는 file> ... -> SDIR/STYLE-1.mp4 ... 말하세요: "받았습니다. 지금 모든 프레임을 측정 중입니다 (약 2분)."

2. 준비, 모두 스크립트로 (~30초/영상)

PY "SK/scripts/prep.py" "SDIR" SDIR/STYLE-*.mp4 SDIR/prep/<reel>/ 안의 각 영상: 단어 단위 자막, 모든 프레임 컷 스캔, 4fps 접촉 시트(시간 포함), 전체 크기 스틸샷, 스펙트로그램, 스테레오 음향 효과 히트, 음량, fingerprint.json (측정된 스타일 수치). 추가로 SDIR/style-check.png와 SDIR/style-spec.json. 지금 style-check.png를 보세요. 만약 한 영상이 다른 영상과 분명히 다른 모양 (다른 레이아웃, 자막, 색상)이면 사용자에게 알리고 교체를 요청하세요. 에이전트를 사용하기 전에. WORK/progress/01-style-check.png로 복사하세요.

3. 분석, 영상당 하나의 에이전트, 병렬로 (~15분)

references/breakdown-brief.md를 영상당 한 번 채우고 한 메시지로 실행하세요. 각각 SDIR/prep/<reel>/edit-log.md를 작성합니다. 실행되는 동안 4단계의 폰트 매칭을 수행하세요.

4. 폰트 매칭 (~20초)

PY "SK/scripts/font_match.py" SDIR/STYLE-1.mp4 SDIR/prep/STYLE-1/transcripts/STYLE-1.words.json "SDIR/font" font-match.png를 보세요: 승자가 시각적으로 일치해야 합니다. 상위 두 개가 0.01 이내 차이면 두 번째 영상에서도 실행하세요. (Kallaway: Archivo 800 at -0.045 em 점수 0.773, Helvetica Neue Bold의 0.759보다 높음.)

5. 스타일 가이드로 병합 (직접, ~10분)

references/merge-guide.md를 따르세요: 합의된 규칙, 측정된 수치, 직접 확인할 키프레임 시트, 촬영 섹션. 출력: SDIR/STYLE-style-guide.md + SDIR/STYLE-key-frames.png. 키프레임 시트를 사용자에게 열어 보여주고 한 문단 요약을 제공하세요.

6. 스타일 스킬 만들기 (~2분 + 직접 재작성, ~30분)

SYS "SK/scripts/make_style_skill.py" STYLE "SDIR" --title "표시 이름" 검증된 엔진(ENGINE, 이 스킬 옆에 있음)을 ROOT/.claude/skills/STYLE-edit/에 복제: 사용자 자신의 비디오 폴더에 있는 프로젝트 스킬, 전역 스킬 폴더가 아니므로 업데이트가 영향을 주지 않습니다. 복사본은 DATA를 공유합니다 (두 번째 설치 불필요). 일치 도구(scripts/match/)를 추가하고, 측정된 명세로 style.json을 작성하며, 스타일 가이드에서 재작성할 스타일 파일 체크리스트를 출력합니다 (SKILL.md 스타일 규칙, style-rules.md, graphics-recipes.md, sound-map.md, filming-guide.md, kit CSS/JS, 그리고 스타일에 다른 레이아웃이 있는 경우에만 build.py의 레이아웃). 목록의 모든 항목을 재작성하세요. 엔진 스크립트는 레이아웃이 필요하지 않으면 그대로 둡니다.

7. 스타일 잠금 (~45-60분)

references/lock.md를 따르세요: 사용자 영상으로 테스트 편집 -> 일치 점수 -> 수정 -> 참고 윈도우의 황금 재현 -> 수정 -> 비평가 라운드 -> 귀 확인 -> 최종 승인. 모든 숫자를 STYLE-edit/references/lock-log.md에 기록하세요.

8. 전달

사용자에게 알리세요: 새 명령어 (/STYLE-edit, Claude Code가 ROOT에서 열릴 때마다 사용 가능; 표시되지 않으면 Claude Code를 다시 시작), 한 문단으로 설명, 일치 점수와 황금 수치, 촬영 방법 (촬영 섹션에서 3~4개 불릿), 그리고 여전히 일치하지 않는 부분.

타이밍 (M4 Pro Mac, ~1.5분 영상 3개 기준)

fetch 1분 · prep 1.5분 · 분석 15-18분 (병렬) · 폰트 매칭 20초 · 병합 10분 · 스킬 만들기 2분 + 재작성 30분 · 잠금 45-60분. 총 약 2시간, 대부분 에이전트와 렌더링.

파일

scripts/: fetch.py, prep.py, fingerprint.py (측정/명세/점수), font_match.py, golden.py, make_style_skill.py, engine.py (ENGINE 찾기). references/: breakdown-brief.md, merge-guide.md, lock.md. templates/: style-rules.md, graphics-recipes.md, lock-log.md (새 스타일 스킬에 복사됨).