kajisho5/ffmpeg-skill

これは何？

主な機能

• 01可能な場合はロスレスのストリームコピーを使い、クリップのカット、結合、無音部分の除去ができます。
• 029:16へのクロップやぼかし背景での余白埋めを含め、映像を目標の尺やアスペクト比に合わせられます。
• 03カラオケ風のタイミングと、各プラットフォームのセーフゾーンに収まる折り返しに対応した字幕を焼き込めます。
• 04EBU R128の目標値に合わせたラウドネスの正規化と、HDR映像からSDRへの変換ができます。
• 05argparseの定義から生成される仕様に基づき、すべてのツールをMCP経由で利用できます。

ユースケース

• 長時間の録画から、ReelsやTikTok向けの60秒の縦型動画をエージェントに作らせる。
• フォルダー内のポッドキャストやSNS向け素材のラウドネスを一括で正規化し、書き出す。
• クラウドの編集サービスにアップロードせず、映像に字幕やオーバーレイを焼き込む。
• 各出力をffprobeで確認してから次の工程に渡す、スクリプト化された動画パイプラインを構築する。

クイックスタート

1. 1

   Claude Code 用のスキルをインストールする

   npx ffmpeg-skill
2. 2

   ffmpeg、ffprobe、および必要なコンポーネントが揃っていることを確認する

   npx ffmpeg-skill doctor
3. 3

   機械可読なツールコントラクトを読む

   npx ffmpeg-skill contract --json | head -40

使う前に知っておきたいこと

• !PATH に ffmpeg と python3 があらかじめインストールされている必要があります。
• !インストーラーがコピーしたファイルは自動更新されません。更新するにはインストールコマンドを再実行してください。
• !caption.py など一部のツールには、基本的な Homebrew ビルドには含まれていない場合がある subtitles フィルターなどの FFmpeg コンポーネントが必要です。

トピック

よくある質問

ffmpeg-skill とは？

Claude Code、Cursor、Codexなどのコーディングエージェントに、ローカルで使える42種類のFFmpeg編集ツールを提供するAgent Skill／MCPサーバー。 ffmpeg-skillを使うと、コーディングエージェントはffmpegとffprobeをローカルで実行する構造化されたPythonスクリプトを呼び出し、動画や音声を編集できます。42種類のツールで、クリップのカットや結合、無音部分の除去、尺やアスペクト比に合わせた映像の調整、字幕の焼き込み、オーバーレイ、HDRからSDRへの変換、ラウドネスの正規化、録音間の同期、TikTok、Reels、YouTube、Xなどのプラットフォームに合わせた書き出しができます。

ffmpeg-skill は無料で使えますか？ライセンスは？

ffmpeg-skill は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

ffmpeg-skill は今もメンテナンスされていますか？

活発にメンテナンス中。ffmpeg-skill の最終コミットは 2026年10月17日 です。

ffmpeg-skill は何に使えますか？

長時間の録画から、ReelsやTikTok向けの60秒の縦型動画をエージェントに作らせる。 フォルダー内のポッドキャストやSNS向け素材のラウドネスを一括で正規化し、書き出す。 クラウドの編集サービスにアップロードせず、映像に字幕やオーバーレイを焼き込む。 各出力をffprobeで確認してから次の工程に渡す、スクリプト化された動画パイプラインを構築する。

ffmpeg-skill のインストール方法は？

Claude Code 用のスキルをインストールする: npx ffmpeg-skill ffmpeg、ffprobe、および必要なコンポーネントが揃っていることを確認する: npx ffmpeg-skill doctor 機械可読なツールコントラクトを読む: npx ffmpeg-skill contract --json | head -40

ffmpeg-skill はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/kajisho5/ffmpeg-skill