ffmpeg-skill：把本地视频剪辑能力装进 AI 编程助手

是什么：ffmpeg-skill（kajisho5 出品，1641 星，MIT，纯 Python 标准库）是一个 Agent Skill，把本地 FFmpeg/ffprobe 封装成 42 个结构化工具，供 Claude Code、Cursor、Codex 及任何读取 SKILL.md 的 Agent 使用，npx ffmpeg-skill 一行安装，也可作为 MCP 工具调用。

核心设计：固定"probe → 无损优先编辑 → check → verify"流程：先探测时长、帧率、分辨率、色彩与音频布局再定参数；完成后重新 probe，画面有变化时用 contact sheet 让 Agent 亲眼检查。SPEC 机制让每个工具的 input_schema 在运行时从同一 argparse 解析器派生，CI 防止 CLI 与 MCP 契约漂移；工具不经 shell 执行、不接受调用方传入的 filter graph，规避注入与猜参。

亮点：本地优先、零账号零 API Key，素材不出机器；contract --json 提供机器可读契约；MCP 默认只暴露 12 个核心工具以节省上下文，FFMPEG_SKILL_MCP_FULL=1 才展开全部；doctor 可逐工具检测组件缺失（如 Homebrew ffmpeg 缺 subtitles 滤镜时 caption.py 不可用）；tiktok/reels 等平台模板内置画幅、−14 LUFS、字幕安全区与交付检查。

坑与边界：它是"手"不是"脑"，切点决策、成片审批、字幕文案由生态中的 brain 类项目负责；重跑安装命令才更新副本；强依赖 PATH 上的 ffmpeg/python3（Windows 下命令名有差异）；仓库成熟度仅有元数据佐证，需自行验证。