media-convert

media-convert

ffmpeg ベースの動画・音声形式変換 skill。Bash 直叩きで毎回引数を思い出す手間を消し、Web 配信向け / 互換性重視 / 受講者配布向けの preset に集約する。

起動条件

ユーザーの発話に以下が含まれた時、本 skill を即起動する:

• 形式変換: 「mov を mp4 に」「mp4 を webm に」「動画変換」「変換して」
• 圧縮: 「動画圧縮」「軽くして」「ファイルサイズ削減」
• 音声: 「音声抽出」「mp3 にして」「音だけ取り出す」
• GIF: 「GIF 化」「mov を gif に」
• 一般: 「ffmpeg」「video convert」

基本ワークフロー

Step 1. ffmpeg 存在確認 ── scripts/check-ffmpeg.sh (or .ps1)
Step 2. 未インストールなら ── references/ffmpeg-install.md を Read してユーザーに OS 別手順提示
Step 3. preset 選択 ── references/presets.md を Read、入出力形式 + 用途で適切な preset を 1 つ選ぶ
Step 4. ファイル存在確認 ── 入力 path 確認、出力 path 衝突確認
Step 5. ffmpeg コマンド実行 ── scripts/convert.sh <preset> <in> <out> もしくは直接 ffmpeg コマンド
Step 6. 結果確認 ── 出力ファイル size, 再生時間, codec を ffprobe で確認

OS 検出

# Bash 系 (Mac/Linux/WSL/Git Bash)
case "$(uname -s)" in
  Darwin*) OS=mac ;;
  Linux*)  OS=linux ;;
  MINGW*|MSYS*|CYGWIN*) OS=windows-bash ;;
esac

# Windows PowerShell 系
$OS = if ($IsWindows) { "windows" } elseif ($IsMacOS) { "mac" } else { "linux" }

OS 検出結果で HW accel (Mac: videotoolbox / Nvidia: nvenc / Intel: qsv / Linux: vaapi) の preset 候補を絞り込む。

preset 一覧 (詳細は references/presets.md)

preset	入力	出力	用途
mp4-web	動画全般	mp4 (H.264 + AAC)	Web 配信 / SNS、QuickTime/Safari 互換、+faststart
mp4-quicktime	mov 等	mp4	macOS 標準プレイヤー再生重視、yuv420p 強制
mp4-hwaccel-mac	動画全般	mp4	Apple Silicon HW accel (videotoolbox)、爆速
webm-vp9	動画全般	webm (VP9 + Opus)	Web 配信、高圧縮率、Chrome/Firefox 最適
webm-av1	動画全般	webm (AV1 + Opus)	次世代 codec、最高圧縮率、エンコード遅い
mp4-handout	動画全般	mp4	受講者配布用、720p / CRF 28 / 軽量
mp3-extract	動画全般	mp3	音声抽出 (128k VBR)
wav-extract	動画全般	wav	音声無劣化抽出 (PCM)
gif-quality	動画全般	gif	palette 最適化 GIF、Slack/note 貼付向け
mp4-trim	動画全般	mp4	開始/終了時刻指定切り出し

起動時の確認 (Step 3 で必須)

ユーザーに 形式 + 用途 を確認してから preset 選択する:

• 「mp4 にしてほしい?」(QuickTime 再生用 / Web 配信用 / 配布用 で preset 違う)
• 「webm にしてほしい?」(VP9 = 圧縮率重視 / AV1 = 最高品質 で preset 違う)

迷ったら mp4-web / webm-vp9 を推奨。

注意事項

• 上書き防止: 出力 path が既存ファイルと衝突する場合、ffmpeg は -y なしだと上書き確認プロンプトを出す。skill から実行する時は必ず確認後 -y 付与。
• 長尺ファイル: 30 分以上の動画は変換時間が長い。run_in_background: true で実行し、Monitor で進捗確認。
• 音声なし動画: -c:a を -an (audio none) に変える必要あり。preset 既定は音声あり前提。
• HW accel と品質: videotoolbox / nvenc / qsv は CRF 指定不可、bitrate 指定 (-b:v 5M 等) で品質制御。
• Windows path: PowerShell 経由なら "C:\path\to\file.mov" 引用必須。空白含む path 注意。

ファイル構成

.claude/skills/media-convert/
├── SKILL.md                      # 本ファイル
├── references/
│   ├── presets.md                # preset 詳細 (ffmpeg 引数フル展開)
│   ├── ffmpeg-install.md         # Mac/Windows/Linux インストール手順
│   └── platform-notes.md         # OS 別注意点 (HW accel / path / shell 差異)
├── scripts/
│   ├── check-ffmpeg.sh           # bash 用 ffmpeg 検出
│   ├── check-ffmpeg.ps1          # PowerShell 用 ffmpeg 検出
│   └── convert.sh                # preset 引数化変換 (bash)
└── examples/
    └── batch-convert.sh          # 複数ファイル一括変換例

関連

• ffmpeg 公式: https://ffmpeg.org/documentation.html
• VP9 encoding guide: https://trac.ffmpeg.org/wiki/Encode/VP9
• H.264 encoding guide: https://trac.ffmpeg.org/wiki/Encode/H.264