一个日本视频工程师把 FFmpeg 交给了 Claude Code:64 天 4,600 星,靠的是「先量、再剪、剪完自己检查」

一个只有一个公开仓库、X 上 6,500 粉的日本直播视频工程师,9 月 3 日建了个库,叫 ffmpeg-skill,让 Claude Code、Cursor、Codex 在本地剪视频。到 11 月 6 日它有 4,594 星、369 个 fork。功能上它不算新,早一年就有好几个 FFmpeg MCP,都停在一两百星。这篇讲它多出来的那二十倍星是从哪来的,以及你能不能照着给自己的项目也来一次。

一条日语推文,一串能直接说出口的话

2026 年 9 月 4 日下午,东京时间一点多,X 账号 @kebura_P 发了一条日语帖:「我做了一个让 AI agent 能好好用上 FFmpeg 的 Skill。」下面没讲架构,先列了五句话:

「把这个视频改成 9:16」「把没声音的部分剪掉」「加字幕」「把 iPhone 的 HDR 转成 SDR」「导出成适合 X 的格式」

然后才说它不只是一份命令清单:先 probe 素材,能不重编码就不重编码,处理完检查结果,再对一遍交付规格。最后两句:本地处理,视频不用上传到云;「想让 AI 剪视频、又嫌 FFmpeg 麻烦的人」用。

这条帖到 11 月 6 日有 7.8 万浏览、1,470 赞、1,813 次收藏。收藏比赞多,说明大家是当工具存起来以后用的。作者是日本一家做活动直播的公司 SEVENTHWELL 的视频工程师,发帖时 X 上 6,494 个粉丝。当天中文微博、新浪就有人转述,韩文站 9 月 4、5 日转载,9 月 7 日 note.com 上有人写日文长文叫它「神工具」。韩文媒体 aifficial 9 月 9 日写:6 天 781 星。

它到底做了什么

一句话:把 FFmpeg 拆成 42 个参数写死的 Python 小脚本,外加一份 agent 读得懂的说明书,让 agent 不再自己拼 ffmpeg 命令。

README 开头的 Why 段被后来几乎每篇介绍原样引用:

An agent that "knows FFmpeg" still guesses: it assumes a frame rate, picks a codec the container cannot hold, re-encodes a file that only needed a stream copy, and reports "done" without opening the result.

懂 FFmpeg 的 agent 其实在猜:猜帧率,选了容器装不下的编码,本来只要拷贝流的文件也重编码一遍,没打开结果就说「做完了」。它的解法是一条固定流程:先 probe 量出真实的时长、帧率、分辨率、色彩和声道,能无损就无损,做完再 probe,对照目标平台的规格检查,画面变了就出一张缩略图拼板让 agent 自己看一眼。README 里的例子是一句话「把 interview.mp4 的 0:45–3:10 和 5:00–6:30 留下,剪成正好 60 秒发 Reels」,agent 依次跑六个脚本,最后回一句「final.mp4:59.98 秒,1080×1920,30 fps,AAC 立体声」。

几个工程细节撑起了「靠谱」这个说法:每个脚本的 MCP 参数定义从同一个 argparse 解析器自动生成,CI 检查有没有对不上;不接受调用方传进来的 shell 字符串和滤镜图;MCP 默认只露 12 个核心工具,省上下文;CI 在 FFmpeg 6.1、7.1、8、9 四个版本上跑。装法是一行 npx ffmpeg-skill,只用 Python 标准库,有 ffmpeg 就能跑,不要账号也不要 API key。

星是一波一波叠出来的

它的星不是哪一天爆出来的,是三四波转发叠起来的,中间靠高频发版保持曝光。

Tom Dörr 那条只有一句:「Add 42 video editing tools to Claude Code, Cursor, and MCP clients with npx ffmpeg-skill.」他有 22 万粉,专转 GitHub 新工具。这条 10.3 万浏览、2,141 赞、3,028 次收藏,把它从日语圈和技能目录带进了英文开发者主流。npm 上近 30 天约 2 万次下载,波峰和星数波峰对得上。不过 npx 每跑一次都算一次下载,157 个版本也会把数字放大,只能当方向看。

中间几波都接得上,是因为作者发版快得离谱:64 天 488 个提交、345 个 PR、157 个 release,PR 作者里有 claude、cursoragent、openhands-agent,他是让 agent 给自己迭代的。newreleases、devotd 这类站点每个版本自动生成一页「vX.Y 发布」,typingmind、skillsmp、claudepluginhub、mcpmarket 等十几个技能目录自动收录,每次都等于被重新报道一次。

为什么是它,不是早一年的那几个

同样把 FFmpeg 包给 agent:video-creator/ffmpeg-mcp、egoist/ffmpeg-mcp 等 2025 年上半年就有,89–216 星,基本停了;KyaniteLabs/kinocut 定位几乎一样,「带护栏的视频剪辑 MCP」,248 星。差别有三处:

1. 它叫 skill,不只是 MCP。 2026 年秋天正是 Agent Skills 格式流行、「用 Claude Code 自动剪 Shorts」教程满天飞的时候。每份「该装哪个视频 skill」的盘点都要列一个处理现成素材的 FFmpeg 层,名字最直白的就是它,知乎「180 个视频 Skill 盘点」、ai211「四个开源视频 Skill」都收了。
2. 它讲的是「会自己检查」,不是「工具多」。 「agent 其实在猜」这句话戳中所有让 agent 跑过 ffmpeg 的人,「不上传素材、不要 key」是第二个钩子。
3. 作者有一个能爆的号,还用母语首发。 6,500 粉不算多,但在日语 Claude Code 圈子里够精准;帖子没写架构,写的是五句能直接对 agent 说的话。

三条缺一条,大概都到不了 4,600。作者还另开了十几个配套库(字幕、调色、质检、remotion-ffmpeg 等),每个只有 0–18 星。生态没给这个库带来星,反过来是它在给作者引流。

谁在抢这个位置

大的都在做「生成视频」,小的都没起来。「把 FFmpeg 稳稳交给 agent」这个窄位置 9 月还空着,被它用最直白的名字占了。没发现照抄它的;同名的 n0an/ffmpeg-skill 建得比它早,15 星。

星是真的吗

有一处不太对称:作者 GitHub 主页 0 个关注者,仓库只有 7 个 watcher。但 fork 和星的比例约 8%(同龄同量级新库的中位数约 11%,不算低),每一波涨星都能对上一条具体的推文或一批文章。判断是自然增长,刷星的可能性低,但没法完全排除:stargazer 明细这次没拿到,账号质量没抽样。

如果是你

判断:B。 这套打法能照着用,但 FFmpeg 这个位置已经被占了,「xx-skill」也早就不是空地:近 120 天新建、名字里带 skill 的库有 876 个,过千星的 45 个(GitHub 数据,11-06)。现在要赌的是你挑的工具有没有一股内容热潮在后面推,以及你有没有一个能让首帖爆起来的圈子。

适合谁: 本身是某个老牌命令行工具的重度用户,知道 agent 用它时在哪儿出错;在某个语种或垂直圈子里有几千个精准关注者;能接受两个月里几乎天天发版。

不适合谁: 想再做一个视频剪辑 skill 的(FFmpeg 层有它,生成层有 HeyGen、Remotion、Browser Use);想用工具数量取胜的(42 个工具不是它火的原因);只打算发一次、不维护的。

怎么做: 挑一个「agent 都说自己会、实际老是用错」的老工具,包成参数写死的脚本,固定一条「先量 → 再做 → 做完检查」的流程,给一份机器可读的说明,一行 npx 或 pipx 装好,不要 key 也不要云。名字直接叫「工具名-skill」。11-06 看,还没有像样 skill 版本的有:pandoc(只有一个 586 星、建了快两年的 MCP)、yt-dlp(MCP 300 星,skill 214 星)、ImageMagick、GDAL、SoX(库里没找到成气候的)。Blender、KiCad、FreeCAD 已经有几千到三万星的 MCP,别去。

怎么获客: 用母语首发,帖子别讲架构,列五句能直接对 agent 说的话,再加一句「不上传、不要 key」。首帖起来后,把 README 的 Why 段写成别人能整段抄走的样子;然后保持每周几个版本,让版本聚合站和技能目录反复收录;攒到一两千星时去找 Tom Dörr 这类专转新工具的英文号。

什么时候之前: 「Claude Code 剪视频」这波已经在降温(周涨星从 1,833 掉到 715)。下一波热潮落在哪个工具上说不准,做法是现在就盯「用 Claude Code 做 xx」的教程和盘点文,哪类开始密集出现,两三周内把对应的 skill 发出来。

什么情况说明看错了: ① 你的首帖收藏不到几百、一周不到 300 星,说明圈子或选题不对,换工具,别硬撑;② 同一工具一个月内冒出三个以上同类 skill,窄位置已经没了;③ Anthropic 或工具官方自己出了 skill(像 Remotion 那样),个人做的同类基本就到头了。

数据与出处:GitHub 仓库与 README(11-06);每日星数来自 GitHub 读数(10-17 起)和 Trendshift;作者首帖 x.com/kebura_P/status/2095736887034212809、Tom Dörr 转推 x.com/tom_doerr/status/2115405924646985924 的浏览、赞、收藏为 11-06 读数;aifficial.net 9-09 报道;npm 下载来自 api.npmjs.org;竞品和同类 skill 库的星数为 11-06 GitHub 读数。写「判断」「说不准」的地方是推断。