kajisho5/ffmpeg-skill

What is it?

Key features

• 01Cut, join, and remove silence from clips with lossless stream copy where possible.
• 02Fit footage to a target duration and aspect ratio, including 9:16 crop and blur fill.
• 03Burn captions with karaoke-style timing and platform safe-zone wrapping.
• 04Normalise loudness to EBU R128 targets and convert HDR footage to SDR.
• 05Expose all tools over MCP, with a contract generated from the argparse definitions.

Use cases

• Letting an agent turn a long recording into a 60-second vertical clip for Reels or TikTok.
• Batch-normalising loudness and exporting podcast or social deliverables from a folder.
• Adding burned-in captions and overlays to footage without uploading it to a cloud editor.
• Building a scripted video pipeline that checks each output with ffprobe before passing it on.

Quick start

1. 1

   Install the skill for Claude Code

   npx ffmpeg-skill
2. 2

   Check that ffmpeg, ffprobe and required components are present

   npx ffmpeg-skill doctor
3. 3

   Read the machine-readable tool contract

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

Things to know

• !Requires ffmpeg and python3 to already be installed on your PATH.
• !Copies installed by the installer are not updated automatically; re-run the install command to refresh them.
• !Some tools, such as caption.py, need FFmpeg components like the subtitles filter that a basic Homebrew build may lack.

Topics

FAQ

What is ffmpeg-skill?

An Agent Skill and MCP server giving coding agents like Claude Code, Cursor and Codex 42 local FFmpeg video and audio editing tools. ffmpeg-skill lets a coding agent edit video and audio files by calling structured Python scripts that drive ffmpeg and ffprobe locally. The 42 tools cover cutting and joining clips, removing silence, fitting footage to a duration or aspect ratio, burning captions, overlays, HDR to SDR conversion, loudness normalisation, sync between recordings, and exports tuned for platforms such as TikTok, Reels, YouTube and X.

Is ffmpeg-skill free to use? What license does it have?

ffmpeg-skill is open source under the MIT license. Check the license terms before using it in commercial products.

Is ffmpeg-skill still maintained?

Actively maintained. The last commit to ffmpeg-skill was on Oct 17, 2026.

What can I use ffmpeg-skill for?

Letting an agent turn a long recording into a 60-second vertical clip for Reels or TikTok. Batch-normalising loudness and exporting podcast or social deliverables from a folder. Adding burned-in captions and overlays to footage without uploading it to a cloud editor. Building a scripted video pipeline that checks each output with ffprobe before passing it on.

How do I install ffmpeg-skill?

Install the skill for Claude Code: npx ffmpeg-skill Check that ffmpeg, ffprobe and required components are present: npx ffmpeg-skill doctor Read the machine-readable tool contract: npx ffmpeg-skill contract --json | head -40

Where can I get ffmpeg-skill?

The source code and installation instructions are on GitHub: https://github.com/kajisho5/ffmpeg-skill