Communitygithub.com

editar-video

전문가 수준으로 실제 비디오를 편집합니다. ffmpeg를 사용하여 색상 보정(노멀라이즈 → 밸런스 → 장면 매칭 → 룩), 채도, 대비, BT.709 레벨, 피부 톤, iPhone HLG를 SDR로 변환, 컷, J/L 컷, 레이어, 텍스트, 자막, LUT .cube, 확대/안정화, 음량 등을 처리하며, Reels/TikTok용으로 최종 출력합니다. 색상은 측정(스코프 및 숫자)으로 판단하며, '보기 좋다'는 기준으로 판단하지 않습니다.

editar-video란 무엇인가요?

이 스킬은 실제 비디오를 전문가 수준으로 편집하는 AI 에이전트(Claude Code, Cursor 등)를 위한 종합 가이드입니다. ffmpeg와 ffprobe를 기반으로 색상 보정, 피부 톤 보정, iPhone HLG에서 SDR 변환, 컷, J/L 컷, 텍스트/자막 추가, LUT 생성, 확대/안정화, 음량 조정 등 전체 편집 워크플로우를 다룹니다. 핵심 원칙은 '측정된 색상 판단'입니다. 모든 색상 변경은 스코프(waveform, parade RGB, vectorscope)와 숫자 데이터로 뒷받침되며, 시각적 판단이 아닌 정량적 분석을 기반으로 합니다. 사용자는 '비디오 편집', '색상 보정', '장면 매칭', 'LUT 적용', '컷', '자막 처리' 등 다양한 명령으로 이 스킬을 호출할 수 있습니다. 이 스킬은 5단계로 구성됩니다: (1) 입력 파일 분석 및 HDR/가변 프레임레이트 확인, (2) 장면별 측정 기반 진단 및 사용자 확인, (3) 측정 기반 보정 계획 및 미리보기 승인, (4) 렌더링 및 전후 비교 측정, (5) 컷/레이어/텍스트/자막 추가, 최종 리뷰 및 전달. 출력 형식은 Meta/TikTok 가이드라인을 따릅니다. 이 스킬은 모션 그래픽을 다루지 않습니다. 모션 그래픽이 필요한 경우 `/motion` 스킬을 사용하세요.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/arthurmkt/arthur-portfolio-mkt/tree/main/design/editar-video

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

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

문서

측정 기반 비디오 편집

원칙: 색상은 측정으로 판단합니다. 모든 색상 변경 제안은 그 동기(스코프, 백분위수, 피부 각도)를 숫자로 제시하고, 변경 후 숫자도 함께 제시합니다. 이 스킬의 모든 규칙에는 출처가 표시되어 있습니다. 출처가 없는 것은 **[출처 없음]**으로 표시되며, 절대 규칙으로 사용되지 않습니다.

명시된 한계: 저는 프레임과 숫자를 볼 뿐, 비디오를 재생하며 보지 않습니다. 리듬, 컷의 느낌, 룩의 취향은 요청자가 판단할 몫입니다. 전달 시에는 반드시 요청자가 휴대폰으로 확인하도록 요청합니다.

요구 사항: ffmpeg 및 ffprobe (8.1.2에서 테스트, libvidstab 포함 R61), Python 3.10+ 및 numpy와 Pillow (pip install numpy pillow).

파일

파일용도
scripts/escopos.py장면별 진단: 스코프 시트 (waveform, parade RGB, 피부 톤 라인이 있는 vectorscope, 히스토그램) + 경고 및 출처가 포함된 diagnostico.md/json
scripts/comparar.py장면별 전후 비교: 시트, 1080p split_cenaN.png, 숫자 표 및 해결/새로운 경고
scripts/graduar.py신호 순서대로 보정 계획(JSON)을 RGB 16비트로 적용; --previa는 정지 프레임 전후 생성
scripts/gerar_lut.py승인된 보정을 .cube (33/65)로 변환하여 Premiere/Resolve/CapCut에 적용하고 PSNR로 증명
scripts/montar.py목록(JSON) 기반으로 하드 컷, J 컷, L 컷으로 클립 조립
scripts/receitas.py출처가 있는 38개 ffmpeg 레시피; testar clipe.mp4는 모두 실행; md는 referencias/receitas-ffmpeg.md 생성
referencias/cor-fluxo.md신호 순서, 대비, 커브, 채도, 16비트 정밀도
referencias/niveis-e-escopos.mdBT.709, EBU R103 v3.0, 각 스코프 읽는 방법, 스크립트 측정 방법
referencias/pele.md피부 톤 라인, 크로마 범위, 증상 → 원인 → 보정
referencias/hdr-hlg.mdiPhone HLG → SDR, BT.2408 레벨, 측정 체인
referencias/corte.mdMurch (6가지 규칙, 깜박임), 액션 컷, J/L 컷, 오디오 편집, 동기화
referencias/plataformas.mdMeta 및 TikTok: 형식, 안전 영역, 길이, 공식 및 비공식 정보
referencias/receitas-ffmpeg.md그룹별 38개 레시피 (입력, 진단, 색상, 룩, 컷, 레이어, 모션, 마무리, 오디오, 전달)

작업 폴더: 작품당 하나의 폴더 (예: editar-video/<프로젝트>/<작품>/): 원본, 계획, 미리보기, 시트 및 최종 파일을 함께 보관합니다.

아래 명령에서 ~/.claude/skills/editar-video는 스킬이 설치된 위치입니다. 다른 위치에 설치했다면 조정하세요.


단계 0 — 입력 (게이트 없음)

python ~/.claude/skills/editar-video/scripts/receitas.py mostrar R01   # 파일로 실행

다른 모든 것보다 먼저 ffprobe 숫자를 기준으로 결정합니다:

  • color_transfer=arib-std-b67 (HLG) 또는 smpte2084 (PQ) → 먼저 SDR로 변환 (referencias/hdr-hlg.md, R03). 태그만 변경하지 마세요.
  • r_frame_rate ≠ avg_frame_rate → 가변 프레임레이트: 컷 전에 R02 적용 (Meta는 고정 프레임레이트 요구, Ads Guide).
  • color_range=pc → 변환 전에 콘텐츠가 실제로 0–255인지 확인 (R04). signalstats는 범위 태그를 무시합니다.
  • AI 파일, 화면 녹화: 일반적으로 태그 없이 전체 범위로 제공됩니다. 측정 전에 가정하지 마세요.

단계 1 — 측정 기반 진단 (게이트 1)

python ~/.claude/skills/editar-video/scripts/escopos.py bruto.mp4 -o diag            # SDR
python ~/.claude/skills/editar-video/scripts/escopos.py bruto.mp4 -o diag --sdr      # HLG: 톤매핑 후 측정
python ~/.claude/skills/editar-video/scripts/escopos.py bruto.mp4 --pele 0.35,0.15,0.3,0.25   # 얼굴 영역

시트를 VER(보기) → AMPLIAR(확대) → CONFIRMAR(확인) 방식으로 읽습니다: 프레임, 각 스코프, 마지막으로 숫자. 다음을 표시합니다:

  1. 시트 (folha_escopos.png) 및 장면별 표;
  2. 측정된 사실, 한 줄에 하나씩, 규칙 및 출처 포함: "장면 2: 하이라이트 R 98,6 / G 90,0 / B 80,2 → 하이라이트에 따뜻한 색상이 우세함, 벽이 흰색이면 (Adobe, parade RGB)";
  3. 측정으로 알 수 없는 것 (예: 따뜻한 톤이 의도적인지 여부).

자동 피부 마스크 (Chai & Ngan)는 갈색, 베이지, 주황색을 잡아냅니다. 얼굴이 작거나 같은 색상의 물체가 있는 경우 --pele로 얼굴 영역을 전달하세요.

게이트 1: 요청자가 문제가 무엇이고 의도가 무엇인지 확인합니다. 요청자가 원하는 색상 우세를 수정하지 않습니다.

단계 2 — 보정 계획 및 미리보기 (게이트 2)

plano.json 작성 (graduar.py 상단의 형식 참조). 각 작업에는 측정된 이유가 "porque" 필드에 포함됩니다. 고정 순서: 컨폼 → 글로벌 → 장면별(매칭) → 룩 → 마무리 → 합법화 (referencias/cor-fluxo.md, 섹션 1).

  • 노멀라이즈: 채널별 블랙/화이트 포인트 (niveis)를 baixas_RGB / altas_RGB에서 계산합니다.
  • 밸런스: 먼저 온도, 그 다음 그린/마젠타 (temperatura, balanco).
  • 장면 매칭: 참조 장면 선택 (가장 밝거나 원하는 룩에 가장 가까운 장면, Colorist Guide 20, 레슨 2)하고 다른 장면의 Y 평균, 하이라이트 RGB 및 피부 톤을 근사화합니다.
  • 룩: 장면 매칭 후에만 적용합니다. 스타일 채도, 크리에이티브 LUT. 룩은 취향입니다: 제안하고 요청자가 결정합니다.
python ~/.claude/skills/editar-video/scripts/graduar.py plano.json --mostrar   # 필터 체인
python ~/.claude/skills/editar-video/scripts/graduar.py plano.json --previa    # 각 장면 중간의 전후

게이트 2: 미리보기 승인. 조정은 장면과 정도를 명시합니다 ("장면 3, 따뜻함 절반"). 요청된 것만 변경합니다.

단계 3 — 렌더링 및 측정 비교 (게이트 3)

python ~/.claude/skills/editar-video/scripts/graduar.py plano.json
python ~/.claude/skills/editar-video/scripts/comparar.py bruto.mp4 corrigido.mp4 -o comparacao --zoom-vs 2

folha_antes_depois.png + comparacao.md (전후 숫자, 해결 및 새로운 경고, 장면 간 진폭)를 제공합니다. 새로운 경고가 발생하면 표시 전에 수정합니다.

게이트 3: 요청자가 보정된 비디오를 시청하고 승인합니다.

단계 4 — 컷, 레이어, 텍스트, 모션 (요청 시)

  • 컷: JSON 형식의 클립 목록 → montar.py (하드, J, L). 규칙과 출처는 referencias/corte.md에 있습니다. 샷 길이와 분당 컷 수를 측정합니다. 리듬은 요청자가 판단합니다.
  • 텍스트, 자막, 로고: R50–R52, 항상 플랫폼 안전 영역 내 (referencias/plataformas.md). 텍스트는 닫힌 목록의 리터럴 텍스트입니다. 자막은 음성을 따르며, 단어 3개당 1초 + 1초의 읽기 시간을 갖습니다.
  • 비디오 위 모션: 이징이 있는 줌/팬 (R60), 안정화 (R61), 속도 (R62).
  • 처음부터 모션 그래픽 (운동 타이포그래피, 애니메이션 숫자): /motion 스킬 사용, 비디오는 프레임 시퀀스로 입력됩니다.
  • 순서: 그래픽과 자막은 색상 및 HDR→SDR 변환 후에 추가됩니다 (ITU-R BT.2408-9 §9).

단계 5 — 리뷰 및 전달

표시 전 체크리스트:

  1. comparar.py에서 최종 레벨/색역 경고 없음; BT.709 태그가 ffprobe로 확인됨.
  2. 해상도, 고정 fps, 길이, 프레임 수, 시작/끝에 검은 프레임 없음.
  3. 텍스트가 안전 영역 내에 있음; 자막이 음성과 일치함.
  4. 음량 측정 (R80) 및 정보 제공. -14 LUFS 목표는 [공식 출처 없음]; 요청자가 동의하면 사용합니다.
  5. 인코딩 R90 (H.264, yuv420p, BT.709, +faststart).
  6. TikTok TopView인 경우 처음 3초 동안 강한 플래시나 순백색 없음 (plataformas.md).
  7. 요청자에게 휴대폰으로 확인 요청: 리듬, 느낌, 피부 톤.

재사용될 승인된 룩 → gerar_lut.py --plano plano.json -o <프로젝트>_look.cube 및 --conferir로 증명.

코드 규칙 (ffmpeg 8.1.2, 2026-11-05 기준)

  1. RGB 색상 필터는 format=gbrp16le 뒤에 옵니다. 8비트에서는 왕복 시 평균 Y 코드가 1.1 손실됩니다. 16비트에서는 정확하게 출력됩니다.
  2. 10비트/HLG 스트림에서 eq를 사용하지 마세요. 8비트로 강제 변환됩니다.
  3. 필터 경로: file='/폴더/파일.cube' (작은따옴표; : 또는 공백이 있는 경로는 `)로 이스케이프 필요).
  4. 출력 태그: -colorspace bt709 -color_primaries bt709 -color_trc bt709 -color_range tv (+ graduar.py 체인 끝에 setparams).
  5. 합법화는 마지막에만 수행합니다 (EBU R103 v3.0). limiter는 RGB 색역을 수정하지 않습니다. RGB16 단계에서 이미 클리핑합니다.
  6. -ss는 reencode와 함께 -i 앞에 사용하면 정밀 컷; -c copy를 사용하면 키프레임에서 컷이 발생합니다.

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

관련 스킬