Communitygithub.com

TaherZiad/montage-crew

비디오 편집 파이프라인의 두 번째 에이전트입니다. 말하는 머리 녹화에서 말더듬, 반복된 단어, 잘못된 시작, 재녹음된 대사(리테이크) 등 음성 실수를 찾아 제거합니다. 무음 제거 후에 사용하며, 실수 제거, 말더듬/반복/필러 재시작 제거, 더듬거림 정리, 최고 테이크 유지 등을 요청할 때 사용됩니다. 리뷰 게이트 방식으로 작동합니다. 즉, 각 컷을 컨텍스트와 제안 사유와 함께 제시하고 승인된 컷만 ffmpeg를 통해 렌더링합니다. 단어 수준의 트랜스크립트가 필요합니다.

montage-crew란 무엇인가요?

TaherZiad/montage-crew는 말하는 머리 녹화 편집을 위한 2단계 AI 에이전트입니다. 1단계(무음 제거) 이후에 실행되며, 숙련된 인간 편집자가 두 번째 패스에서 제거하는 음성 실수(말더듬, 반복 단어, 잘못된 시작, 리테이크)를 자동으로 찾아 제거합니다. 이 에이전트는 강조 반복이나 수사적 이중 표현과 같은 미묘한 차이를 기계적으로 판단할 수 없기 때문에 '리뷰 게이트' 방식으로 설계되었습니다. 먼저 'find-cut-candidates.mjs' 스크립트가 트랜스크립트에서 후보 컷을 찾아 구조화된 JSON과 읽기 쉬운 마크다운 제안서를 생성합니다. 그런 다음 사용자나 상위 에이전트가 각 후보의 컨텍스트와 제거/유지 텍스트를 검토하여 승인 여부를 결정해야 합니다. 마지막으로 'apply-cuts.mjs' 스크립트가 승인된 컷을 적용하여 ffmpeg로 동기화된 오디오/비디오 파일을 생성하고, 모션 그래픽 에이전트가 사용할 업데이트된 트랜스크립트도 함께 만듭니다. 이 에이전트는 Claude Code와 같은 터미널 기반 AI 에이전트 환경에서 사용하도록 설계되었습니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/TaherZiad/montage-crew/tree/HEAD/skills/montage-crew/references/external/hyperframes-student-kit

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

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

문서

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

자동 편집의 두 번째 단계로, 무음 제거 후에 실행됩니다. 인간 편집자가 두 번째 패스에서 제거하는 것들을 제거합니다: 말더듬("그 그", "저- 저-"), 즉시 반복되는 단어, 잘못된 시작(중단 후 다시 시작하는 구절), 그리고 리테이크(다시 녹음된 대사 — 깔끔한 테이크 유지, 망친 테이크 제거).

무엇이 실수인지 판단하는 것은 공식이 아닌 판단입니다 — 강조 반복("절대, 절대")과 수사적 이중 표현("첫 번째 조각은, 이것은…")은 기계적으로 말더듬과 동일하게 보입니다. 따라서 이 에이전트는 기본적으로 리뷰 게이트 방식입니다: 전체 컨텍스트와 함께 후보를 제시하고, 에이전트(및 사용자)가 결정하며, 승인된 컷만 렌더링됩니다.

사용 시기

  • "실수 제거", "말더듬/반복 제거", "더듬거림 정리", "최고 테이크 유지", "잘못된 시작 제거" 요청 시
  • 마스터 편집 워크플로우의 두 번째 단계로, 무음 제거의 출력에 대해 실행합니다.

세 부분 흐름

1. 후보 찾기 (기계적)

node .claude/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를 읽으세요. 일반적인 오탐: 강조 반복("그것은 절대, 절대 자율적이지 않습니다"), 계사-의문문("그 조각은, 이것은…"), 목록 나열.

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

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

(start/end는 입력 트랜스크립트/비디오 타임라인의 초 단위입니다. 후보의 범위를 확장할 수 있습니다 — 예를 들어 리테이크의 경우 망친 테이크 시작부터 깔끔한 재시작까지 컷합니다.)

3. 승인된 컷 적용

node .claude/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 트림+연결, A/V 동기화)를 작성합니다. --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 3 individual skills — each has its own dedicated page.

TaherZiad/montage-crew

Cut silences and dead weight (fillers, repeated takes, false starts) out of a talking-head video BEFORE building the edit - call the measured /auto-trim API instead of hand-rolling ffmpeg, review the dead-weight candidates it returns, and do the one job only a human/AI can do (spotting repeated POINTS). Read this when the brief enables "Tự động cắt ngắn video" (autoCut) or the user complains that the video still has dead weight/silences.

TaherZiad/montage-crew

Membangun motion graphic sinematik di browser (promo video, opener, intro, bumper, kinetic typography, explainer/video penjelasan bergambar 16:9 atau 9:16) memakai HTML + CSS + GSAP (+ Three.js bila perlu), dengan hasil yang bergerak seperti video sungguhan — bukan slide presentasi. Gunakan skill ini setiap kali user meminta "video promo", "opener", "intro animasi", "motion graphic", "bumper", "kinetic typography", "animasi teks sinematik", "explainer", "video penjelasan" (jurnalisme visual, kartun edukasi, kolase), atau menunjukkan referensi video promosi/explainer dan ingin dibuatkan versi web-nya — bahkan bila mereka tidak menyebut kata "motion graphic" secara eksplisit. Juga gunakan bila user mengeluh hasil animasi web "seperti PPT/presentasi" dan ingin lebih sinematik, atau ingin merender animasi web menjadi file video MP4, atau ingin explainer kartun/animasi dibangun LANGSUNG di After Effects lewat bridge/MCP Higgsfield.

TaherZiad/montage-crew

Arabic short-video editor (any dialect). Edits talking-head videos and screen recordings, or builds an MG-led video from an idea with no footage - retakes and silences cut, Arabic RTL captions and hook, premium motion graphics, SFX, music, -14 LUFS master, cover - for 9:16, 16:9 or both. Delivers the MP4 plus a project for Resolve, Premiere, After Effects, CapCut or Final Cut. Asks a few questions on first use, keeps the user's brand kit, offers style cards, learns styles from videos, links and MG sites the user shows it, and learns the user's rules after each video. Use when the user asks to edit a video («منتجلي هذا الفيديو», «سوّي مونتاج», «أضف ترجمة», «قص الصمت», «بستايل …», "edit my video"), make a video from an idea («ما عندي فيديو، عندي فكرة», «فكرة فيديو عن…»), learn a style («تعلّم من هذا الفيديو», «هذا الموشن يعجبني»), save a brand («احفظ هويتي», «اقترح لي هوية») or change settings («غيّر إعداداتي»).

관련 스킬