How to edit video locally from Claude Code and Codex with ffmpeg-skill
ffmpeg-skill is an agent skill that lets coding agents such as Claude Code, Codex and Cursor cut footage, burn in captions, and fit aspect ratio and loudness with the FFmpeg on your own machine. It ships 42 tools. After an edit, it measures the output file again and renders a contact sheet so the agent can check the result visually. No cloud, no API keys, Python standard library only.
- Have FFmpeg 6.1+ and Python 3.10+. On macOS, install
ffmpeg-full; the plainffmpegformula lacks the subtitles, drawtext and zscale filters.
brew install ffmpeg-full
ffmpeg-full is keg-only, so if there is no ffmpeg on your PATH at all, add export PATH="$(brew --prefix ffmpeg-full)/bin:$PATH" to your shell profile.
- Install the skill and check that every FFmpeg component the tools need is present. By default it installs for Claude Code (
~/.claude/skills/ffmpeg-skill); add--codexfor Codex,--cursorfor Cursor, or--allfor all three. On Claude Code 2.1.275 or later you can also install it as a plugin with/plugin install ffmpeg-skill --marketplace kajisho5/ffmpeg-skill.
npx ffmpeg-skill
npx ffmpeg-skill doctor
- Ask your agent for the edit in plain words.
Take interview.mp4, keep 0:45–3:10 and 5:00–6:30, and make it exactly 60 seconds for Reels.
The agent probes the file first, then runs the cut, a 9:16 crop fitted to 60 seconds, a Reels export and a platform check, and reports the duration, resolution and frame rate. Inputs are never overwritten; outputs are new files named <input>_<operation>.<ext>.
Captions from speech (--transcribe) need a local speech engine installed separately, such as pip install faster-whisper, which downloads its model on first run. Installed copies do not update themselves; re-run npx ffmpeg-skill to get a new version. The license is MIT.
Get notified when a new tip lands
Tip alerts only go out in the app. Install it and turn notifications on.