Communitygithub.com

TTTAAXXTTT/video-editing-workflow

사용자 개인의 전체 비디오 편집 워크플로우 및 에셋 패키지로, 여행/vlog/액션캠/모바일/클라우드 대용량 파일 등 다양한 영상 소스로부터 완성된 하나의 영상을 제작합니다.

video-editing-workflow란 무엇인가요?

이 스킬은 사용자가 "편집/영상 제작/vlog/하나로 편집/완성본/추억 영상"을 요청하거나, 소스 파일이 많고 크기가 커서 어시스턴트가 전체 다운로드 및 후반 작업을 수행한 후 최종 완성본만 전달해야 할 때 사용됩니다. 표준화된 워크플로우와 재사용 가능한 스크립트(다운로드 감시, 시스템 복원, 프레임 그리드, 색보정 및 컷 편집, 병합, 최종 검증) 및 전체 리뷰와 문제 해결 매뉴얼을 포함합니다. 구체적인 필터와 톤은 고정되어 있지 않으며, 사용자의 요청에 따라 그때그때 결정됩니다. 지원 플랫폼은 Claude Code, Cursor, Codex 등 AI 어시스턴트 환경이며, 사용자 로컬 저장소를 사용하지 않고 어시스턴트 작업 디렉토리에서 모든 작업을 수행합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add TTTAAXXTTT/video-editing-workflow

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

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

문서

비디오 편집 표준 워크플로우

핵심 순서: 요구사항 파악 → 모든 소스 확보 → 개별 확인 → 내러티브에 맞게 샷 선택 → 정밀 편집 → 오디오 → 검증 → 완성본만 전달. 기본적으로 다운로드 및 중간 파일을 사용자 로컬에 저장하지 않습니다.

0. 작업 시작 전 한 번에 질문

용도/플랫폼, 화면 비율 (가로 16:9 / 세로 9:16), 목표 길이, 템포 속도, 오디오 (순수 BGM/현장음/해설), 자막 및 제목, 톤 스타일 (사용자가 결정하며 필터는 고정되지 않음).

1. 소스 획득 (사용자 로컬 하드 디스크 사용 안 함)

소스는 어시스턴트 영구 작업 디렉토리에 다운로드; 클라우드 MCP는 일반적으로 파일 관리만 가능하며 다운로드나 클라우드 편집은 불가능; 공식 클라이언트 단일 동시 연결이 일반적으로 가장 빠르고 안정적이며, 다운로드 감시 기능과 함께 중단점 재개/저메모리 재시작 지원. ffprobe로 개수와 무결성 확인.

2. 개별 확인, 놓치지 않음

각 파일에 대해 여러 프레임을 추출하여 그리드로 전체 확인; 장면, 조명, 구도, 사용 가능/제외 사유 주석.

3. 샷 선택 (내러티브 + 다양성)

감정선: 눈길을 끄는 오프닝 → 전개 → 발전 → 절정 → 마무리 여운; 원근/명암/물/다리/그늘진 길/굽은 길/넓은 풍경 교차, 동일 유형 반복 방지; 소스 파일 + 정확한 시작점 기록.

4. 정밀 편집

통일된 화면 비율 및 fps; 색보정은 사용자의 당시 요청에 따라 전체 분위기 조성, 샷별로 조정 가능, 기존 필터 값 사용 안 함; 느린 템포 부드러운 디졸브; 저메모리 상황에서 단계별 처리, 중단 시 멱등성 있게 재개 가능.

5. 자막 (사용자가 필요한 경우만)

가는 흰색 글씨 부드러운 그림자, 페이드 인/아웃, 풍경 가리지 않음; 한글은 Noto CJK 사용.

6. 오디오

순수 BGM: 현장음 제거, 길이 맞춤, afade로 페이드 인/아웃, loudnorm으로 모바일 쾌적한 음량 (약 I=-16).

7. 압축 및 패키징

대상 비트레이트 VBV로 크기 제어 (입자감/강한 분위기일 때는 비트레이트 완화); H264 + AAC, -movflags +faststart.

8. 검증

ffprobe 사양; blackdetect로 중간에 검은 프레임 없음 확인; 프레임 그리드로 색보정/순서/샷 누락/음악 시작 및 종료 확인; 손상된 부분 재처리.

9. 전달

present_files로만 완성본 전달; 간단한 표로 사양 및 처리 사항 설명; 피드백에 따라 반복, 각 라운드에서 사용자가 지적한 부분만 수정.


리소스 탐색

스크립트는 scripts/에 있습니다 (실행 권한 이미 부여, 매개변수 안내에 따라 수정하여 사용):

  • make_grid.py: 일괄 프레임 추출 그리드로 영상 확인 (2단계)
  • make_clips.py: 샷 컷 + 색보정 분위기 적용, 통일된 세그먼트 출력 (4단계; 필터는 예시 값이며 필요에 따라 재작성)
  • join.py: xfade 부드러운 디졸브 + 앞뒤 검은 프레임, 사용자 정의 샷 순서 지원 (4/7단계)
  • verify_final.py: 완성본 사양 + 검은 프레임 + 프레임 그리드 최종 검증 (8단계)
  • download_watchdog.sh: 대용량 파일 다운로드 감시, 메모리 부족 방지, 자동 재시작 (1단계)
  • recover.sh: 시스템 디스크 리셋 후 클라이언트 재설치 + 라이브러리 보충 (1단계)

참조 문서는 references/에 있습니다 (필요할 때만 읽기):

  • full-workflow.md: 전체 워크플로우 리뷰 + 한 차례 모터사이클 여행 vlog의 실제 샷 목록, 필터 매개변수, 5차례 반복 경험
  • troubleshooting.md: 클라우드 획득, 저메모리, 시스템 리셋, 로그인, 인코딩 등 모든 문제 및 처리 방법

민감 정보 (계정 쿠키, 인증 코드, 전화번호)는 어떤 스크립트, 문서 또는 로그에도 기록하지 않습니다.

관련 스킬