Communitygithub.com

F0rger123/claude-영상-편집-신-모드

영상 편집 파이프라인의 두 번째 에이전트입니다. 말하는 사람의 녹화에서 더듬음, 반복된 단어, 잘못된 시작, 재녹음된 대사 등 말하기 실수를 찾아 제거합니다. 침묵 구간 자르기 이후에 사용하며, 실수 제거, 더듬음/반복/필러 재시작 정리, 최고 테이크 유지 등의 요청에 응답합니다. 검토 게이트 방식으로 작동하여 모든 컷을 맥락과 이유와 함께 제안한 후 승인된 컷만 ffmpeg로 렌더링합니다. 단어 수준의 대본이 필요합니다.

claude-영상-편집-신-모드란 무엇인가요?

이 스킬은 자동 영상 편집 파이프라인의 두 번째 단계입니다. 첫 번째 단계(침묵 구간 자르기) 이후에 실행되며, 사람 편집자가 두 번째 패스에서 수행하는 작업인 더듬음('the the', 'I- I-'), 바로 반복된 단어, 잘못된 시작(중단되고 다시 시작된 구절), 재녹음된 대사(깨끗한 테이크는 유지하고 망친 테이크는 버림)를 제거합니다. 무엇이 실수인지 판단하는 것은 공식이 아닌 판단에 기반하므로, 이 에이전트는 기본적으로 검토 게이트 방식으로 작동합니다. 즉, 전체 맥락과 함께 후보를 제시하고, 에이전트(및 사용자)가 결정하며, 승인된 컷만 렌더링됩니다. 기계적 탐지기는 의도적인 강조('never, never')와 수사적 이중 표현('the first piece is, is this...')을 실제 더듬음과 구별하지 못하므로, 각 후보를 맥락에서 검토하고 추천을 맹목적으로 신뢰하지 말아야 합니다. 이 스킬은 Cursor, Claude Code, Codex와 같은 AI 에이전트 플랫폼에서 사용하도록 설계되었으며, Node.js 스크립트와 ffmpeg를 활용하여 컷 후보를 찾고, 승인된 컷을 적용하며, 검토를 위한 EDL(편집 결정 목록) 파일을 생성합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/F0rger123/claude-video-editing-god-mode/tree/HEAD/.agents/skills/cut-mistakes

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

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

문서

실수 및 반복 제거 (파이프라인 에이전트 2)

자동 편집의 두 번째 단계로, 침묵 구간 자르기 이후에 실행됩니다. 사람 편집자가 두 번째 패스에서 제거하는 것들을 제거합니다: 더듬음("the the", "I- I-"), 바로 반복된 단어, 잘못된 시작(중단되었다가 다시 시작되는 구절), 재녹음된 대사(다시 녹음된 대사 중 깨끗한 테이크는 유지하고 망친 테이크는 버림).

무엇을 실수로 간주할지는 공식이 아닌 판단에 달려 있습니다. 강조 반복("never, never")과 수사적 이중 표현("the first piece is, is this…")은 기계적으로 더듬음과 동일하게 보입니다. 따라서 이 에이전트는 기본적으로 검토 게이트 방식입니다: 전체 맥락과 함께 후보를 제시하고, 에이전트(및 사용자)가 결정하며, 승인된 컷만 렌더링됩니다.

사용 시기

  • "실수 제거", "더듬음/반복 제거", "실수 정리", "최고 테이크 유지", "잘못된 시작 제거"
  • 마스터 편집 워크플로우의 두 번째 단계로, 침묵 구간 자르기의 출력물에 대해 실행.

세 부분으로 구성된 흐름

1. 후보 찾기 (기계적)

node .agents/skills/cut-mistakes/scripts/find-cut-candidates.mjs \
  <silence-transcript.json> --out-dir video-projects/<slug>/assets

입력은 일반적으로 에이전트 1의 <stem>.silence-transcript.json이므로, 컷은 이미 침묵이 제거된 타임라인에 적용됩니다. 다음 파일을 씁니다:

  • <stem>.cut-candidates.json — 구조화된 후보 (유형, 신뢰도, 제안된 cut 범위, removes/keeps 텍스트, 맥락, 추천)
  • <stem>.cut-candidates.md — 읽기 쉬운 제안서

후보 유형: stutter (즉시 단어 반복), retake (Jaccard 유사도를 통한 중복/거의 중복 세그먼트), false_start (중단 후 다시 시작되는 짧은 구절).

2. 검토 (게이트 — 필수)

각 후보를 맥락에서 읽고 유지 또는 제거를 결정합니다. 기계적 탐지기는 의도적인 강조/수사적 표현과 실제 실수를 구분할 수 없으므로, recommend를 맹목적으로 신뢰하지 말고 removes + context를 읽으십시오. 일반적인 오탐: 강조 반복("it's never, never hands-off"), 계사-의문문("the piece is, is this…"), 나열.

후보를 사용자에게 각 항목별 추천과 함께 제시하고 승인을 수집합니다. 승인된 컷을 파일에 씁니다:

{ "cuts": [ { "start": 100.93, "end": 101.06, "reason": "I- 잘못된 시작" }, ... ] }

(start/end는 입력 대본/비디오 타임라인의 초 단위입니다. 후보의 범위를 넓힐 수 있습니다. 예를 들어 재녹음의 경우 망친 테이크의 시작부터 깨끗한 재시작까지 자릅니다.)

3. 승인된 컷 적용

node .agents/skills/cut-mistakes/scripts/apply-cuts.mjs \
  <silence-transcript.json> --cuts approved-cuts.json \
  --video video-projects/<slug>/assets/edited-silenced.mp4 \
  --output video-projects/<slug>/assets/edited-clean.mp4 --apply

EDL, 다시 시간이 조정된 <stem>.mistakes-transcript.json (모션 그래픽 에이전트 + validate-beat-sync.mjs에 입력), 결정 로그를 쓰고, --apply와 함께 실행하면 컷된 비디오(ffmpeg 트림+연결, 오디오/비디오 동기화)를 씁니다. --apply를 빼면 드라이 런이 됩니다.

결과 검토

공유 검토 도구를 사용하여 컷을 눈으로 확인하고 경계를 샘플 점검합니다:

node scripts/build-edl-review.mjs <stem>.mistakes-edl.json \
  --original video-projects/<slug>/assets/edited-silenced.mp4 \
  --edited   video-projects/<slug>/assets/edited-clean.mp4 \
  --output   video-projects/<slug>/assets/mistakes-review.html
npx serve . -p 8080 -n

참고 사항

  • 매우 깔끔한 전달의 경우 실제 컷이 거의 또는 전혀 없을 수 있습니다. 이는 유효한 결과입니다. 할당량을 채우기 위해 자연스러운 말을 자르지 마십시오.
  • 두 개의 말하는 단어 사이의 컷은 하드 조인입니다. 일반적으로 더듬음/잘못된 시작에 대해서는 깔끔하게 처리되며, 더 타이트한 오디오의 경우 나중에 20-30ms 페이드를 추가할 수 있습니다.
  • mistakes-transcript.json과 깨끗한 비디오를 **에이전트 3 (모션 그래픽 / 계층형 카드)**에 전달합니다.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬