ffmpeg-skill 是给 Claude Code、Cursor、Codex 等智能体用的技能,规定「探测文件、尽量无损剪辑、检查、验证」的固定流程,并自带 42 个基于 ffmpeg / ffprobe 的工具:剪切拼接、去静音、按时长和画幅适配、字幕与卡拉 OK 高亮、HDR 转 SDR、响度标准化、多机位同步、平台交付检查等。每个工具同时是 MCP 工具,参数说明直接从命令行定义生成,CI 会检查两者是否一致;不接受原始 ffmpeg 参数或滤镜图,也不经过 shell。只依赖 FFmpeg 和 Python 标准库,语音转字幕需另装本地识别引擎,音频不出本机。
为什么重要 先测量真实文件再动手,剪完核对时长、画幅和平台规格并看缩略图,不让智能体凭文件名猜参数;全程本地,不要 API Key。
星数 6758(+367 / 24h)
理由
- 24 小时新增 367 星,总星 6758,Trendshift 当日第 3(只代表关注度);MIT 许可
- README 给出每个前后对比演示的原命令,CI 在 FFmpeg 6.1、7.1、8、9 上测试
用法
- 装好 FFmpeg 后运行 npx ffmpeg-skill 装进 Claude Code(Cursor 加 --cursor,Codex 加 --codex),再用 npx ffmpeg-skill doctor 检查本机缺哪些组件;然后说「把 interview.mp4 的 0:45–3:10 和 5:00–6:30 剪出来,做成 60 秒竖屏发 Reels」
风险
- 需要 FFmpeg 6.1 以上和 Python 3.10 以上;部分 Homebrew 版 FFmpeg 缺字幕等滤镜,doctor 会列出哪些工具不能用
- 装好后不会自动更新,要重新运行 npx ffmpeg-skill