video-enhancer — 비디오 향상 파이프라인
여러 비디오의 선명도를 높이고 컬러 그레이딩을 적용하며 오디오를 정규화합니다. 자막은 포함되지 않습니다. 자막이 필요하면 video-captioner 스킬을 사용하세요.
파이프라인
입력 비디오 → unsharp + eq + colorbalance (ffmpeg) → -14 LUFS 오디오 정규화 → 출력
프리셋
| 프리셋 | 선명도 | 채도 | 온도 조정 |
|---|---|---|---|
natural | 미세 | +10% | 없음 |
cinematic | 강함 | +35% | 따뜻하게 (빨간색 증가, 파란색 감소) |
vivid | 강함 | +40% | 없음 |
사용자가 프리셋을 지정하지 않았다면 실행 전에 어떤 스타일을 원하는지 물어보세요. 각 옵션을 간략히 설명하세요: natural은 깔끔하고 절제된 결과, cinematic은 따뜻하고 선명한 인스타그램 스타일, vivid는 최대 색상 강도를 제공합니다.
실행 방법
의존성 설치 (최초 실행 시):
cd "$SKILL_DIR" && uv sync
이후 비디오 처리:
cd "$SKILL_DIR" && uv run python scripts/enhance.py \
--input <입력/경로> \
--output <출력/경로> \
--preset natural|cinematic|vivid
일반적인 호출 예시
# 시네마틱 프리셋
uv run python scripts/enhance.py --input ./input --output ./output --preset cinematic
# 자연 프리셋
uv run python scripts/enhance.py --input ./input --output ./output --preset natural
# 생생한 프리셋
uv run python scripts/enhance.py --input ./input --output ./output --preset vivid
실행 후
사용자에게 다음을 보고하세요:
- 성공적으로 처리된 비디오 수와 실패한 비디오 수
- 출력 디렉토리의 전체 경로
- 실패한 비디오가 있다면 해당 파일 이름을 명시적으로 알려주세요.
예외 상황
ffmpeg가 설치되지 않은 경우: 사용자에게 설치를 안내하세요 (sudo pacman -S ffmpeg(Arch/CachyOS),brew install ffmpeg(macOS),sudo apt install ffmpeg(Ubuntu))uv가 설치되지 않은 경우: https://docs.astral.sh/uv/getting-started/installation/ 로 안내하세요.- 입력 디렉토리가 비어 있는 경우: 조용히 종료하지 않고 명확히 알려주세요.
- 알 수 없는 프리셋이 주어진 경우: 유효한 옵션(natural, cinematic, vivid)을 나열하세요.
- 오디오 정규화 시 짧은 클립에 대해 동적 모드 관련 경고가 출력될 수 있습니다. 이는 정상적인 동작이며 오류가 아닙니다.