# kajisho5/ffmpeg-skill

> ffmpeg-skill is an Agent Skill that lets AI coding agents such as Claude Code, Cursor and Codex cut, join, measure and export video and audio with local FFmpeg. It is a folder of instructions and scripts that an agent loads, so footage is edited on the user's own machine without being uploaded. The project is written mainly in Python and also provides an MCP server.

Source: https://github.com/kajisho5/ffmpeg-skill
Indexed: commit 39b9143 on 2026-11-22 by Repowise. Facts come from the source and git history, not from the maintainer.

## Facts

- Type: MCP server
- Language: Python
- Stars: 9,481 at index time
- License: MIT
- Code health: 3.3/10, At_risk
- Last commit: 2026-11-21
- Contributors: 8

## Install

From the README: https://github.com/kajisho5/ffmpeg-skill#install

Install the skill for every agent found on the machine and install FFmpeg when it is missing.
    npx ffmpeg-skill setup

Check the machine for ffmpeg, ffprobe and the required FFmpeg components.
    npx ffmpeg-skill doctor

Install the skill for Cursor only.
    npx ffmpeg-skill --cursor

## How it works

The installer at bin/install.js is the package's executable entry point, and it copies the skill folder of instructions, scripts and templates into the skill folders of Claude Code, Cursor and Codex. The core media work happens in the scripts folder, which holds one script per operation such as audio mixing, backgrounds, smart cutting and ASS overlays, and each script runs on its own from the command line. The scripts/render.py script runs a whole project in one pass. The mcp/server.py server lets MCP clients list and run the same ffmpeg tools. The evals/run.py entry point grades how an agent used the skill, using the transcript and files from each saved run. The fuzz folder holds a harness that searches for inputs that crash the JSON parser and the ASR word-timing reader.

- bin/install.js: entry point
- evals/run.py: entry point
- mcp/server.py: entry point
- .claude-plugin/marketplace.json: central file
- .claude-plugin/plugin.json: central file
Modules: scripts, tests, .github, evals, fuzz, demos, .clusterfuzzlite, bin. 300 files, 80,363 lines, 4,798 symbols.

## Code health

- Score: 3.3/10 (At_risk)
- Trend: 3.5 on 2026-11-17, 3.3 on 2026-11-22
- Rank: #254 of 4,000+ indexed repos
- Hotspots: none
- Lowest file: scripts/_common/runner.py
- Dead code: none found

## Maintenance

- Last commit 2026-11-21, 500 commits
- 8 contributors, bus factor 1

## Security

- Security findings are shown to signed-in users at https://repowise.dev/repo/kajisho5/ffmpeg-skill/security

## More

- Page: https://repowise.dev/repo/kajisho5/ffmpeg-skill
- Ask this codebase: https://repowise.dev/repo/kajisho5/ffmpeg-skill/chat
- Docs: https://repowise.dev/repo/kajisho5/ffmpeg-skill/docs
- MCP (signs in with Repowise on first use):
    claude mcp add --transport http repowise https://api.repowise.dev/mcp/kajisho5/ffmpeg-skill
