ffmpeg-skill is a skill designed for agents such as Claude Code, Cursor, and Codex. It enforces a fixed workflow of "probe the file, edit losslessly where possible, check, and verify," and includes 42 tools based on ffmpeg / ffprobe: cutting and concatenating, removing silence, adapting to duration and aspect ratio, subtitles and karaoke highlighting, HDR to SDR conversion, loudness normalization, multi-camera synchronization, platform delivery checks, and more. Each tool is also an MCP tool; parameter descriptions are generated directly from command-line definitions, and CI verifies that the two remain consistent. It does not accept raw ffmpeg parameters or filter graphs, nor does it go through a shell. It relies only on FFmpeg and the Python standard library; speech-to-subtitle functionality requires installing a separate local recognition engine, ensuring audio never leaves the local machine.
Why it matters Measure the actual file before starting work. After editing, verify duration, aspect ratio, and platform specifications by checking thumbnails, rather than letting the agent guess parameters based on filenames. The entire process is local, requiring no API Key.
Stars 6758 (+367 / 24h)
Reasons
- 367 new stars in the last 24 hours, total stars 6758, ranked #3 on Trendshift for the day (indicating attention only); MIT license
- The README provides the original commands for each before-and-after demo; CI tests on FFmpeg versions 6.1, 7.1, 8, and 9
Usage
- After installing FFmpeg, run
npx ffmpeg-skillto install it into Claude Code (add--cursorfor Cursor,--codexfor Codex). Then usenpx ffmpeg-skill doctorto check which components are missing on your local machine. Next, say: "Cut out segments 0:45–3:10 and 5:00–6:30 from interview.mp4, and make a 60-second vertical video for Reels."
Risks
- Requires FFmpeg version 6.1 or higher and Python version 3.10 or higher; some Homebrew versions of FFmpeg lack filters such as those for subtitles, and
doctorwill list which tools are unavailable. - Once installed, it does not update automatically; you must re-run
npx ffmpeg-skillto update.