video-enhancer — 動画強化パイプライン
複数の動画に対してシャープ化、カラーグレーディング、オーディオのノーマライゼーションをバッチ処理します。キャプションは付与しません。キャプションが必要な場合は video-captioner スキルを使用してください。
パイプライン
入力動画 → unsharp + eq + colorbalance (ffmpeg) → -14 LUFS オーディオノーマライゼーション → 出力
プリセット
| プリセット | シャープネス | 彩度 | 暖色度 |
|---|---|---|---|
natural | 控えめ | +10% | なし |
cinematic | 強め | +35% | 暖色(赤を強調、青を低減) |
vivid | 強め | +40% | なし |
ユーザーがプリセットを指定していない場合は、実行前にどの見た目にしたいか確認してください。各オプションを簡潔に説明します。natural はクリーンで控えめな仕上がり、cinematic は暖かく鮮やかなInstagram向けグレード、vivid は最大限の色彩強調です。
実行方法
依存関係をインストールします(初回のみ)。
cd "$SKILL_DIR" && uv sync
次に動画を処理します。
cd "$SKILL_DIR" && uv run python scripts/enhance.py \
--input <path/to/input> \
--output <path/to/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がインストールされていない場合:ユーザーにインストールを促します(Arch/CachyOS ではsudo pacman -S ffmpeg、macOS ではbrew install ffmpeg、Ubuntu ではsudo apt install ffmpeg)uvがインストールされていない場合:https://docs.astral.sh/uv/getting-started/installation/ を案内します- 入力ディレクトリが空の場合:静かに終了するのではなく、明確に報告します
- 不明なプリセットが指定された場合:有効なオプション(natural、cinematic、vivid)をリスト表示します
- オーディオノーマライゼーションが短いクリップに対してダイナミックモードに関する警告を表示することがありますが、これは期待される動作でありエラーではありません