Communitygithub.com

YI163/영상-제작

계획, 편집, 색보정, 자막, 품질 검사를 통해 짧은 세로형 영상(브이로그, 캠퍼스/여행, 인터뷰, 브랜드 스토리)을 제작합니다. 사용자가 원본 클립을 45~90초 세로 브이로그로 변환하거나, 한국어 자막을 추가하거나, 타이틀/팩트/엔드 카드를 만들거나, 플랫/Log 푸티지를 보정하거나, 완성된 MP4를 전달하거나, 승인된 컷을 회귀 없이 수정할 때 사용합니다.

영상-제작란 무엇인가요?

이 스킬은 원본 푸티지에서 완성된 짧은 세로형 비디오(브이로그, 캠퍼스/여행, 인터뷰, 브랜드 스토리)를 계획, 편집, 색보정, 자막 삽입, 품질 검사까지 수행하는 종합적인 프로덕션 워크플로우를 제공합니다. 사용자가 짧은 세로 영상 제작, 자막 추가, 색보정, 승인된 버전 수정 등을 요청할 때 트리거되며, '새로운 프로덕션', '로컬 패치', '전체 재작업'의 세 가지 작업 클래스로 구분하여 효율적으로 처리합니다. 핵심은 기존의 성공적인 영상을 단순히 모방하는 것이 아니라, 제작 헌법 작성, 타임스탬프 기반의 객관적인 자료 감사, 실행 가능한 샷 스크립트, 의도적인 비주얼 시스템, 독립적인 리뷰 게이트, 엄격한 기술 QC, 버전 관리된 체크섬 전달의 7단계 프로세스를 재사용하는 것입니다. Claude Code, Cursor, Codex 등 다양한 AI 에이전트 플랫폼에서 실행 가능하며, ffmpeg, Pillow, Whisper 등 실제 도구를 스크립트 형태로 활용하여 기술 레시피와 품질 체크리스트를 포함합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YI163/video-production/tree/main

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

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

문서

비디오 프로덕션

이 스킬의 목적

원본 푸티지를 실제로 게시할 만한 완성된 짧은 세로형 비디오로 만듭니다: 후크, 명확한 스토리, 읽기 쉬운 내장 자막, 의도적인 패키징, 깨끗한 오디오, 그리고 검증된 전달 패키지. 또한 사용자가 변경을 요청할 때 이미 승인된 컷을 보호합니다.

목표는 성공한 하나의 비디오의 샷이나 필터를 복사하는 것이 아닙니다. 목표는 그것을 좋게 만든 조건들을 재사용하는 것입니다:

  1. 편집 전에 작성된 서면 제작 헌법
  2. 분위기가 아닌 타임스탬프가 찍힌 자료 증거
  3. 실행 가능한 샷 스크립트
  4. 의도적인 시각 시스템 (레이아웃, 타이포그래피, 세이프 영역)
  5. 자료 / 스크립트 / 최종 단계에서의 독립적인 검토
  6. 객관적인 기술 QC
  7. 버전 관리되고 체크섬이 있는 전달

사용 시기

  • 사용자가 클립을 제공하고 브이로그 / 짧은 세로형 비디오 / 캠퍼스 또는 여행 영상을 요청할 때
  • 사용자가 내장 자막, 제목, 팩트 카드, 엔드 카드 또는 커버를 요청할 때
  • 사용자가 평탄/Log 푸티지를 보정하거나 샷을 매칭하도록 요청할 때
  • 사용자가 승인된 비디오를 수정하도록 요청할 때: 자막, 음악, 오프닝, 패키징, 몇 개의 샷 교체, 또는 푸티지 교체
  • 사용자가 이전 컷이 왜 좋았는지/나빴는지 묻고 재사용 가능한 프로세스를 원할 때

사용하지 않을 때

  • 사용자가 편집 없이 작성된 개념, 스크립트 또는 샷 리스트만 원할 때
  • 장편 필름/TV 후반 작업, 장편 영화의 색보정, 또는 복잡한 VFX/3D
  • 순수 오디오/팟캐스트 편집
  • 요청이 미디어 검사가 필요 없는 작은 텍스트 전용 답변일 때

단계 0 — 작업 분류 (먼저 수행)

분류신호프로세스
새로운 프로덕션새로운 주제, 새로운 클립, 새로운 결과물전체 워크플로우
로컬 패치자막, 제목, 몇 개의 오버레이, 하나의 B-롤, 볼륨, 음악 페이드만최소 diff + A/B + 재검토
전체 재작업모든/대부분의 푸티지 교체, 레이아웃/화면비/시각 시스템 변경, 그레이드 파이프라인 변경, 스토리 재작성새로운 프로덕션으로 처리; 기존 타임라인 패치 금지

확실한 규칙: "모든 푸티지를 교체" 또는 "이 새 클립들로 다시 작업"은 사용자가 작은 수정이라고 부르더라도 새로운 프로덕션입니다. 기존 스크립트의 소스 타임코드, 프레이밍, 자막 및 B-롤 로직이 더 이상 유효하지 않습니다.

수정인 경우: 아무것도 건드리기 전에 승인된 버전을 고정합니다 (복사 + SHA-256). references/modification-protection.md 참조.


단계 1 — 인테이크 및 프로덕션 헌법

전달에 영향을 주는 것만 캡처합니다:

  • 플랫폼 / 화면비 / 목표 길이 / 언어
  • 푸티지 경로, Log vs Rec.709, 프레임 속도, 오디오
  • 진행자 트랙 유무, 누가 말하는지
  • 음악/라이선싱 (CC0/CC BY/사용자 제공)
  • 전달 폴더/이름/덮어쓰기 정책
  • 변경되어서는 안 되는 것

짧은 00-production-spec.md를 작성합니다 (또는 프로젝트의 기존 것을 재사용):

  • 사양 및 레드라인
  • 사실 기준 (화면에 나타날 수 있는 것; 발언자의 의견일 뿐인 것)
  • 비주얼 문법: 카드 vs 풀블리드, 제목, 자막, 팩트 카드, 엔드 카드, 세이프 영역
  • 사운드 계획
  • 검토 게이트

작업이 작아 보인다고 건너뛰지 마십시오. 사양이 있어야 검토자가 "이것은 합의된 시스템을 위반합니다"라고 말할 수 있고 취향에 대해 논쟁하지 않습니다.


단계 1.5 — 레퍼런스 연구 (새로운 프로덕션 / 전체 재작업)

시각 시스템을 선택하거나 샷 테이블을 작성하기 전에 동일한 플랫폼/장르/길이의 3~5개의 고품질 레퍼런스 브이로그를 연구합니다. 샷이 아닌 원칙을 추출합니다:

  • 처음 1~3초 후크: 이미지 / 단어 / 소리
  • 구조: 샷 수, 평균 샷 길이, A-롤/B-롤 비율, 팩트 카드/엔드 카드 배치
  • 패키징: 자막 크기/위치, 제목, 색상, 전환, 정보 밀도
  • 사운드: 음성, BGM, SFX, 앰비언스
  • 한 문장으로 왜 작동하는지
  • 전이 가능한 원칙 vs 표면적 요소

템플릿은 references/reference-study.md를 사용합니다. 샷 그대로, 얼굴, 음악 또는 저작권 있는 자산을 복사하지 마십시오. 프로젝트에 짧은 reference-study.md를 작성하고 커밋하기 전에 2~3개의 창의적 옵션을 만드는 데 사용합니다. 로컬 패치의 경우 사용자가 요청하지 않으면 건너뜁니다.


단계 2 — 자료 감사 (인상이 아닌 증거)

모든 클립에 대해 기록:

  • 길이 / 해상도 / fps / 코덱 / 비트 심도 / 컬러 태그
  • 타임스탬프별 내용 및 동작
  • 사용 가능한 인/아웃 포인트 (0.5초 정밀도) 및 거부 사유
  • 프레이밍, 헤드룸, 로고/배경, 흔들림, 노출, 화이트 밸런스
  • 오디오: 음성 vs 앰비언스; 음성인 경우 타임스탬프가 있는 대본
  • Log/HLG 또는 Rec.709; 평탄한 경우 그레이드 계획

1초 접촉 시트 + 키 프레임 사용; 첫 번째 대본에 Whisper를 사용한 후 문맥으로 고유 명사 수정. Whisper가 환각한 B-롤 앰비언스를 자막으로 넣지 마십시오.

출력: 프레임과 타임코드가 포함된 자료 보고서, 단순한 산문이 아님. 검토자는 동일한 프레임을 다시 추출할 수 있어야 합니다.


단계 3 — 시각 시스템 및 샷 스크립트

3.1 소스에서 A-롤 처리 선택

  • 카드 레이아웃: 저해상도 가로 (예: 960×720) 또는 환경/로고가 중요할 때: 디자인된 1080×1920 캔버스 위의 4:3/16:9 카드; 2.67배 업스케일을 방지합니다.
  • 풀블리드: 기본 세로 또는 충분한 헤드룸이 있는 4K 가로: 커밋하기 전에 크롭을 테스트합니다.
  • 하이브리드: 얼굴과 문맥이 모두 중요할 때.

사용자가 요청하거나 새 소스가 진정으로 지원할 수 없는 경우가 아니라면 이미 승인된 레이아웃을 변경하지 마십시오. 변경하는 경우 디자인 변경으로 처리하고 재검토합니다.

3.2 무드 보드가 아닌 샷 테이블 작성

모든 샷에는 다음이 필요합니다: 소스, 소스 인/아웃, 최종 인/아웃, 길이, 그림 처리, 자막, 패키징, 전환, 사운드. 길이를 합산합니다; 음성 트랙을 고정 오프셋으로 정렬; 최종 타임코드 자막을 사용합니다.

포함:

  • 처음 3초 내의 후크
  • 2~4초마다 시각/정보 변화
  • 약한 A-롤 섹션을 커버하는 B-롤
  • 팩트 카드 / 엔드 카드 복사본 (출처 및 위험 레이블 포함)
  • 음악/사운드 계획

편집 전에 스크립트를 검토합니다. 잘못된 소스 타임코드는 여기서 수정하는 것이 저렴하지만 나중에는 비용이 많이 듭니다.


단계 4 — 제작

  • 각 샷을 개별적으로 렌더링; 두 번째 패스에서 연결/xfade합니다. 하나의 거대한 필터 그래프를 피합니다.
  • LUT 또는 테스트된 수동 체인으로 Log 푸티지 보정; 샷 간 얼굴 / 흰 벽 / 브랜드 색상을 비교합니다.
  • 오버레이 (제목, 팩트 카드, 엔드 카드, 자막)를 Pillow로 전체 캔버스 RGBA PNG로 생성; 실제 프레임에서 테스트합니다.
  • 자막을 하단 세이프 영역 (하단 여백 ≥200px; 240px가 더 안전함)에 유지, 줄당 ≤14자, ≤2줄.
  • 먼저 음성을 믹싱한 다음 BGM을 그 아래에 (음성보다 1218dB 낮게), 13초 페이드 인/아웃, 약 −16 LUFS로 라우드니스 노멀라이즈, 트루 피크 ≤ −1dBTP.
  • 모든 스크립트, 오버레이, 오디오 및 중간 샷을 버전 관리합니다.

유용한 검사 및 레시피: references/tech-recipes.md.


단계 5 — 리뷰 게이트 (자가 승인 금지)

세 가지 독립적인 게이트:

  1. 자료 게이트 — 연구가 프레임/오디오와 일치합니까? 사용 가능한 범위가 실제인가요? ASR 오류가 수정되었나요? B/C/D 청구되지 않은 앰비언스는 그대로 두었나요?
  2. 스크립트 게이트 — 정확히 작성된 대로 편집할 수 있나요? 소스 인/아웃 포인트가 존재하나요? 자막이 대본과 일치하고 맞습니까? 총 길이가 정확한가요? 후크가 실제인가요?
  3. 최종 게이트 — 전체 필름 프레임 샘플링 + SRT 읽기 + 오디오 확인 + 사실 확인. 기술 QC (해상도, fps, 길이, 라우드니스, 트루 피크, 블랙 프레임, 디코드, 번인)는 별도이며 시각/자막 검토를 대체할 수 없습니다.

각 발견 사항에는 다음이 필요합니다: 타임코드, 증상, 수정, 심각도 (차단/높음/중간/낮음). 통과하려면 차단/높음이 없어야 함; 중간은 수정되거나 명시적으로 수락되어야 함; 낮음은 메모와 함께 출시 가능.

검토가 실패하면 수정하고 영향을 받은 영역을 재검토합니다. "검사기가 통과함"으로 전달하지 마십시오.


단계 6 — 전달

  • 최종 MP4: 1080×1920, 30fps, H.264 High, AAC 48k 스테레오, faststart.
  • 번인과 동일한 큐를 가진 SRT; 1080×1920 커버.
  • 交付说明.md: 사양, 파일, 소스, 구조, 자막, 음악/CC BY, 사실 출처, 알려진 제한 사항, 검토 결과.
  • SHA-256/MD5 매니페스트; 승인된 버전/마스터를 읽기 전용으로 유지.
  • QuickTime/모바일 재생 확인.

단계 7 — 수정

references/modification-protection.md를 따릅니다. 간단히:

  1. 승인된 버전을 고정합니다.
  2. 사용자가 변경을 요청한 것을 정확히 나열합니다.
  3. 다른 모든 것은 "보존해야 함"으로 처리합니다.
  4. 작동하는 가장 작은 패치를 사용합니다.
  5. 재생성이 불가피한 경우 위험을 선언하고 전체 검토를 다시 실행합니다.
  6. 동일한 의미적 비트에서 이전 버전과 새 버전을 A/B 비교합니다.
  7. 유일한 좋은 버전을 덮어쓰지 마십시오.
  8. 새 버전이 실패하면 롤백하고 이전 버전을 유지합니다.

품질 기준 (기본값; 브리핑에 맞게 조정)

항목기본값
캔버스 / fps1080×1920 / 30fps
길이브이로그 4560초; 후크 중심 짧은 영상 1530초
비디오H.264 High, yuv420p, CRF ~18, faststart
오디오AAC 48k 스테레오, ~192kbps
라우드니스−16 LUFS ±2, 트루 피크 ≤ −1dBTP
블랙 프레임의도적인 디자인 외에는 없음
자막번인 + SRT; 하단 여백 ≥200px; 줄당 ≤14자
음악음성 우선; BGM 음성보다 12~18dB 낮게; 페이드 인/아웃
전달MP4 + SRT + 커버 + 전달 노트 + 체크섬

이것들은 법칙이 아니라 기본값입니다. 플랫폼이나 브리핑에 다른 것이 필요한 경우 사양에 작성하십시오.


일반적인 실패 모드 (실제 수정 사례에서)

  • 요청받지 않은 한 승인된 시각 시스템을 변경하지 마십시오. 승인된 컷이 저해상도 가로를 위해 4:3 카드를 사용했습니다; 이후 수정에서 4K 풀블리드 크롭으로 교체했고, 검토자는 가로 푸티지가 단순히 크롭되었다고 불평했습니다. 소스가 가로이고 승인된 모양이 카드였다면, 사용자가 재디자인을 요청하지 않는 한 카드를 유지하십시오; 변경하는 경우 헤드룸/로고/손을 테스트하고 검토하십시오.
  • 팩트 카드 배경은 구별되고 차분해야 합니다. 연속된 카드 뒤에 겹치는 소스 범위 또는 거의 동일한 두 개의 팬을 재사용하지 마십시오; 카메라가 움직이면 배경을 느리게 하거나 고정하십시오. 움직이고 중복된 배경은 "거의 동일한 두 개의 샷" 및 "카메라가 너무 빠르게 스윕"으로 읽힙니다.
  • 모든 브리지 세그먼트에는 기능이 필요합니다. 마지막 팩트 카드와 엔드 카드 사이의 2~3초 샷에는 제목, 음성, 위치 라인 또는 내러티브 비트가 있어야 합니다. 무음, 텍스트 없는 배너는 설명되지 않은 간격으로 읽힙니다; 줄이거나 역할을 부여하십시오.
  • 전체 푸티지 교체는 새로운 프로덕션입니다. 기존 타임라인에 패치하지 마십시오; 자료를 재감사, 재스크립트, 재보정 및 재검토하십시오. "작은 수정" 언어는 범위를 변경하지 않습니다.
  • 기술 통과는 미적 통과가 아닙니다. 검사기는 1080×1920/0 블랙 프레임/디코드 OK를 증명할 수 있습니다; 컷이 좋아 보인다는 것을 증명할 수 없습니다. 수정의 경우 승인된 컷과 A/B 비교하고 독립적인 판정을 받으십시오.

창의적 자유

검증은 표준화하고; 창의적은 열어 둡니다:

  • 개념, 후크, 내러티브 순서
  • 카드 vs 풀블리드 vs 하이브리드
  • 샷 수, B-롤 순서, 전환
  • 그레이드 스타일 (자연스러움 / 따뜻함 / 영화적)
  • 음악 장르, 타이틀 음성, 팩트 카드 시각

승인된 하나의 컷을 템플릿으로 바꾸지 마십시오. 재사용 가능한 자산은 프로세스와 검토 훈련이며, 정확한 글꼴, 샷 또는 음악이 아닙니다.


참조

  • references/case-study.md — 익명화된 사례 연구: 무엇이 잘 작동했고, 무엇이 회귀했으며, 그 이유는 무엇인지.
  • references/workflow.md — 아티팩트 및 게이트가 있는 전체 7단계 워크플로우.
  • references/modification-protection.md — 버전 관리, 최소 diff, A/B, 롤백.
  • references/quality-checklist.md — 사전 점검, 기술, 시각, 자막, 오디오, 전달 체크리스트.
  • references/reference-study.md — 3~5개의 레퍼런스 브이로그를 연구하고 복사 없이 원칙을 추출하는 방법.
  • references/tech-recipes.md — ffmpeg/Pillow/Whisper/라우드니스 레시피 및 알려진 함정.
  • references/skill-sources.md — Agent Skills 형식, 공개 예제 및 호스트 설치 노트 (Claude Code, DSH, 기타 호스트).
  • scripts/check_video.py — 재사용 가능한 기술 검사기.
  • scripts/contact_sheet.sh — 빠른 1초 접촉 시트.

빠른 시작

# 도구 찾기
FF=$(command -v ffmpeg || echo tools/ffmpeg)
$FF -hide_banner -i clip.mp4 2>&1 | grep -E 'Duration|Stream'

# 1초 접촉 시트 (5열)
$FF -hide_banner -loglevel error -i clip.mp4 \
  -vf "fps=1,scale=320:-1,tile=5x6:padding=4:margin=4" \
  -frames:v 1 contact.jpg

# 내보내기 후 기술 검사
python3 scripts/check_video.py final.mp4 --width 1080 --height 1920 \
  --min-duration 45 --max-duration 60 --lufs -16 --lufs-tol 2 \
  --max-true-peak -1.0 --max-black 0.5

사용자가 승인된 버전을 가지고 있다면, 결과물에 쓰는 작업을 실행하기 전에 중지하고 references/modification-protection.md를 읽으십시오.

관련 스킬