ffmpeg-skill
Local video editor for coding agents: 42 FFmpeg tools with a machine-readable contract and an MCP server, for Claude Code, Cursor and Codex. Cut, captions, refr
What is ffmpeg-skill?
Local video editor for coding agents: 42 FFmpeg tools with a machine-readable contract and an MCP server, for Claude Code, Cursor and Codex. Cut, captions, reframe, loudness, platform exports. No cloud, no API keys.
Overview of ffmpeg-skill
What it is
A local video editor for coding agents, providing 42 FFmpeg tools with a machine-readable contract and an MCP server. It is designed for use with Claude Code, Cursor and Codex. It can cut, add captions, reframe, adjust loudness, and export for platforms. It is offline, requiring no cloud services and no API keys.
Key features
- 42 structured FFmpeg tools (e.g., cut, join, silence removal, captions, overlays, loudness)
- MCP server with 12 core tools advertised by default, all 42 reachable by name
- Machine-readable contract (
contract --json) describing every tool's inputs, outputs, required FFmpeg components, and verification method - Results are probed and checked against the destination spec, with a contact sheet when the picture changes
- Local first: no cloud, no API keys, no Python dependencies (optional local transcription available)
Use cases
- Editing video footage locally using an AI coding agent
- Performing common video operations like trimming, joining, and resizing
- Exporting video for social media platforms (TikTok, Reels, YouTube, etc.)
- Adding captions and karaoke effects to videos
- Checking loudness and overall delivery quality of video files
Getting started
bashnpx ffmpeg-skillnpx ffmpeg-skill doctornpx ffmpeg-skill contract --json | head -40
License and pricing
License: MIT. Pricing type: open source.
Based on the project's public README and repository metadata.
