前言¶
给一批视频统一加片头字幕、把长视频按时间段切成短片段、把多个视频拼接并加转场——这类批量处理任务，用剪辑软件手工做重复且不可复现，直接调 FFmpeg 命令行又容易在参数上出错。下面介绍的 Skill「MoviePy Python 视频编辑库」就是针对这个痛点：它把 MoviePy 这个 Python 视频编辑库打包成可调用的 Skill，让开发者用代码完成剪切、拼接、标题插入、合成和自定义效果，结果可复现、可进版本控制。
这是什么¶
这是一个社区来源（source: community）的 Skill，坐标为 @user_3c6cb52e/moviepy-python-video-editing-library，当前版本 1.0.0，分类 design-media，不需要 API Key（requires_api_key=false）。它在 SkillHub 上的评分是 100000，下载 878 次，安装 0 次（数据来自 SkillHub 页面抓取结果）。
它封装的底层库是 MoviePy：一个用 Python 做视频编辑的开源库，由 Zulko 原创并发布在 GitHub，采用 MIT 许可证，底层由 FFmpeg 驱动。MoviePy 在 PyPI 上当前版本为 2.2.1，要求 Python 3.9+，可在 Windows / Mac / Linux 上运行。
一句话定位：如果你的自动化流程需要对视频做脚本化的编辑操作，而不是手工剪辑，这个 Skill 对应的就是这条能力。
核心功能¶
根据 Skill 简介，这个 Skill 覆盖的能力包括：
- 剪切与拼接：截取视频片段、把多个视频接在一起。
- 标题插入：在视频上叠加文字（字体、颜色、位置可定制）。
- 合成（compositing）：非破坏性的多层视频叠加，支持透明度，实现画中画、叠化等效果。
- 自定义效果：通过 Python 代码定义视频或音频效果。
- 格式读写：可读写所有常见的音频和视频格式，包括 GIF。
底层机制上，MoviePy 会把媒体（视频帧、图片、声音）转成 Python 对象（numpy 数组），因此每个像素都可访问，效果可以用几行代码定义；处理完的最终片段再编码回 mp4 / webm / gif 等格式。
需要注意：MoviePy 已升级到 v2.0，这是一个有重大破坏性变更的版本，v1 不再维护。如果在网上搜到 subclip()、set_position() 这类 v1 写法，迁移时要参考官方 v1→v2 升级指南。
安装与启用¶
Skill 本身在 SkillHub 上的安装方式，本次写作时官方页面抓取失败，无法核实具体命令，这里不猜测。Skill 不需要 API Key，标签里已确认。
底层 MoviePy 库的安装命令（来自官方 PyPI 页面）如下：
pip install moviepy
如果你需要自定义 FFmpeg 路径或预览功能，官方文档有专门的安装章节可参考。
要确认本机 FFmpeg 可用，可执行：
ffmpeg -version
MoviePy 依赖系统里的 FFmpeg 完成解码和编码，这一步失败时后续写入会直接报错。
开发环境克隆源码并安装的方式（来自官方仓库 README）：
git clone https://github.com/Zulko/moviepy.git
cd moviepy
pip install -e .
关于在 Cursor、Codex CLI、Claude Code 等客户端中启用该 Skill 的具体差异，本次未能从官方渠道核实，不建议按推测写。
典型用法¶
以下示例来自 MoviePy 官方 PyPI / GitHub 页面，用的是 v2 的 API 写法：打开一个视频，截取第 10 到 20 秒的片段，把音量降到 80%，在画面中央叠加一段文字标题，最后写出新文件。
from moviepy import VideoFileClip, TextClip, CompositeVideoClip
# 加载视频，截取 00:00:10 到 00:00:20 的片段，音量缩放到 80%
clip = (
VideoFileClip("long_examples/example2.mp4")
.subclipped(10, 20)
.with_volume_scaled(0.8)
)
# 生成文字片段：可定制字体、颜色、大小
txt_clip = TextClip(
font="Arial.ttf",
text="Hello there!",
font_size=70,
color='white'
).with_duration(10).with_position('center')
# 把文字叠加到视频上，写出结果
final_video = CompositeVideoClip([clip, txt_clip])
final_video.write_videofile("result.mp4")
这段代码演示了前面提到的三个核心动作：subclipped() 做剪切，TextClip + with_position() 做标题插入，CompositeVideoClip 做合成。读的是本地 example2.mp4（官方仓库自带示例素材），写出 result.mp4。
适用场景与注意¶
适合谁：
- 需要在流水线里批量处理视频的开发者，比如统一加水印、统一改尺寸、批量转 GIF。
- 想把视频处理步骤写成代码、可测试、可复现的团队。
- 已经熟悉 Python 和 FFmpeg，想用更高层的 API 替代手工命令行的开发者。
注意事项：
- 性能：MoviePy 官方明确说明，由于每次都要做媒体数据的导入导出，它比直接调 FFmpeg 慢。批量处理大文件时要评估耗时，或考虑直接用 FFmpeg。
- 版本：v2.0 有破坏性变更，网上大量教程是 v1 写法，迁移前先看官方升级指南，不要把 v1 示例直接粘进 v2 项目。
- 依赖：需要系统安装 FFmpeg；GIF 输出同样走 FFmpeg 编码。
- 环境：要求 Python 3.9 及以上。
结尾¶
这个 Skill 的价值在于把「视频编辑」从手工操作变成可编程的步骤：剪切、拼接、标题插入、合成都能用代码表达，格式覆盖常见的音视频和 GIF，底层由 FFmpeg 保证兼容性。对于以 Python 为主的技术栈，它是目前做脚本化视频处理的常规选择。Skill 页面地址：https://www.skillhub.cn/skills/user_3c6cb52e/moviepy-python-video-editing-library ；底层库文档：https://zulko.github.io/moviepy/ 。
