ffmpeg-skill は、Claude Code、Cursor、Codex などのエージェント向けに設計されたスキルで、「ファイルの検出、可能な限りロスレスな編集、チェック、検証」という固定フローを規定しています。また、42 個の ffmpeg / ffprobe ベースのツールを内蔵しており、カット・結合、無音区間の除去、長さとアスペクト比への適応、字幕およびカラオケハイライト、HDR から SDR への変換、ラウドネス正規化、マルチカメラ同期、プラットフォーム納品チェックなどに対応しています。各ツールは同時に MCP ツールでもあり、パラメータの説明はコマンドライン定義から直接生成され、CI で両者の整合性がチェックされます。生の ffmpeg パラメータやフィルタグラフの受け付けは行わず、シェル経由でもありません。依存関係は FFmpeg と Python 標準ライブラリのみで、音声から字幕への書き出しには別途ローカル認識エンジンのインストールが必要ですが、音声データが外部に出ることはありません。
なぜ重要か まず実際のファイルを測定してから作業を開始し、編集後は長さ、アスペクト比、プラットフォーム仕様を確認した上でサムネイルもチェックします。エージェントがファイル名だけでパラメータを推測するのを防ぎます。全工程はローカルで完結し、API Key は不要です。
スター数 6758(+367 / 24時間)
理由
- 過去 24 時間で新たに 367 スターを獲得し、合計スター数は 6758。Trendshift では当日第 3 位(注目度のみを示す)。ライセンスは MIT。
- README に各機能のビフォーアフターデモ用の元コマンドが記載されており、CI は FFmpeg 6.1、7.1、8、9 でテストを実行しています。
使い方
- FFmpeg をインストールした後、
npx ffmpeg-skillを実行して Claude Code に導入します(Cursor の場合は--cursor、Codex の場合は--codexを追加)。その後、npx ffmpeg-skill doctorでローカル環境に不足しているコンポーネントを確認します。次に、「interview.mp4 の 0:45–3:10 と 5:00–6:30 を切り出し、60 秒の縦型動画にして Reels に投稿して」と指示します。
リスク
- FFmpeg 6.1 以上および Python 3.10 以上が必要です。一部の Homebrew 版 FFmpeg では字幕などのフィルタが欠落している場合があり、
doctorコマンドで利用不可なツールが一覧表示されます。 - インストール後は自動更新されないため、更新するには再度
npx ffmpeg-skillを実行する必要があります。