Communitygithub.com

기본 색상 보정 & 샷 매칭 스킬

노출을 정규화하고, 화이트 밸런스 색조를 중립화하며, 피부톤 IRE 레벨을 보호하고, OpenCV 가상 스코프와 프리미어 프로 Lumetri 기본 보정을 사용하여 B-롤 클립을 A-롤 히어로 샷에 매칭합니다. 창의적인 LUT나 스타일라이즈드 그레이드를 적용하기 전에 이 스킬을 실행하세요.

기본 색상 보정 & 샷 매칭 스킬란 무엇인가요?

이 스킬은 프리미어 프로에서 전문적인 1차 색상 보정과 샷 매칭을 자동화합니다. 창의적인 LUT나 스타일 그레이드를 적용하기 전에 사용자가 기본 노출, 화이트 밸런스, 피부톤 및 환경 채도를 정규화할 수 있도록 도와줍니다. 스킬은 OpenCV 기반 가상 스코프를 실행하여 각 클립의 루마(IRE) 값, RGB 패레이드 캐스트, 피부톤 메트릭을 분석하고, Lumetri 기본 보정을 위한 수학적으로 도출된 권장 1차 보정값을 생성합니다. 그런 다음 A-롤 히어로 클립과 B-롤 클립 간의 델타 기반 매칭을 수행하여 최종 그레이드 전에 일관된 노출, 온도, 틴트 및 채도를 보장합니다. 이 스킬은 Windows, macOS, Linux에서 Claude Code, Cursor, Codex와 같은 AI 에이전트와 함께 작동하며,. 유일한 외부 종속성은 Python(OpenCV 및 NumPy 라이브러리 포함)입니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/umangkaushik17-bit/ReferenceEditTemplate/tree/HEAD/.agents/skills/balancing-primary-color-and-skins

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

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

문서

기본 색상 보정 & 샷 매칭 스킬은(는) 무엇을 하나요?

이 스킬을 사용해야 하는 경우

  • 프리미어 프로에서 창의적인 룩이나 미적 그레이드를 적용하기 전.
  • A-롤 토킹헤드 클립과 B-롤 컷어웨이의 조명, 노출 또는 색온도가 일치하지 않을 때.
  • 원본 푸티지가 평평하게(Log/Flat) 보이거나, 노출 부족이거나, 실내 텅스텐/실외 블루 캐스트가 있는 경우.

1단계: 가상 스코프 텔레메트리 실행 (활성 화면만)

  1. 각 타임라인 클립에서 대표 프레임을 내보내거나 (또는 02_analysis/clip_frames/의 클립 프레임 폴더를 직접 가리켜) 다음을 실행합니다:
    python .agents/skills/balancing-primary-color-and-skins/scripts/virtual_scopes.py --frames_dir 02_analysis/clip_frames --output 02_analysis/color_telemetry.json --match_to <hero_clip_stem>
    
  2. 기본적으로 (auto_crop_active=True), extract_active_region은 IRE 백분위수를 계산하기 전에 정적 검은색 레터박스/필러박스/윈도우박스 막대를 자동으로 제거하므로, 검은 막대가 p01_black 또는 p50_mid를 0으로 끌어내리지 않습니다. 명시적인 전체 프레임 매팅 플레이트를 검사할 때만 --no_crop_active를 전달하세요.
  3. 02_analysis/color_telemetry.json을 읽습니다:
    • active_region: 확인된 크롭 경계 상자 [x, y, w, h] 대 full_size.
    • luma_ire: p01_black, p25_shadow, p50_mid, p75_high, p99_white, dynamic_range.
    • rgb_parade_cast: 중립 미드톤에서의 r_bias, g_bias, b_bias.
    • skin_metrics: skin_detected, skin_luma_ire (55-70 IRE), YCrCb 시프트.
    • environment_metrics: mean_saturation_pct, green_fraction, sky_blue_fraction, warm_fraction.
    • recommended_primary_lumetri: 수학적으로 도출된 패스 1 값 (하이라이트 안전을 위해 p99_white > 94.0일 때마다 exposure <= 0 적용).

2단계: 패스 1 기본 정규화 적용 (트랙 V1 및 V2)

기본 Lumetri Color 효과를 통해 각 클립의 recommended_primary_lumetri 기준선을 적용합니다. 이는 글로벌 트랙 V4 크리에이티브 그레이드보다 먼저 적용됩니다.

3단계: 패스 2 샷 간 매칭 (match_delta_to_hero)

--match_to <hero_clip>을 사용하여 기본 A-롤 히어로 클립을 지정하고, 컷어웨이 및 멀티 스트립 패널 전반에 match_delta_to_hero (exposure_delta, temperature_delta, tint_delta, contrast_delta, highlights_delta, shadows_delta, saturation_delta)를 적용하여 트랙 V4 스타일링 전에 모든 클립이 일관된 노출, 온도 및 녹색 채도를 공유하도록 합니다.

관련 스킬