Communitygithub.com

github774/video-edit

使用本地 video-tools MCP(基于 ffmpeg)编辑真实视频素材:裁剪、拼接、去除讲话视频中的静默停顿、添加字幕、叠入自动闪避的背景音乐、重新构图至 9:16 / 1:1 / 4:5、标准化响度并按平台导出。适用于用户提供视频文件并说“剪辑这段”、“编辑这段”、“去除停顿/空白”、“添加字幕”、“加入音乐”、“做成竖版”、“从这段剪个短视频”、“导出到 TikTok/YouTube”或“清理音频”等场景。

video-edit 是什么?

这是一个基于视频编辑 MCP 技能,利用本地的 video-tools(封装自 ffmpeg)实现对真实录制视频的确定性、可验证编辑。它支持从查看源文件、裁剪片段、去除讲话视频中的静默停顿、拼接多个片段、烧录字幕(支持 .srt 和 .ass 格式)、添加自动闪避的背景音乐、重新构图(竖屏/正方形)、变速、提取缩略图候选、标准化响度以及按平台参数(YouTube、Shorts、TikTok、Reels、X、LinkedIn、Web-small、ProRes)一键导出的完整工作流。该技能适用于 Cursor、Claude Code 等支持 MCP 协议的 AI 编程助手,用户只需提供视频文件并给出自然语言指令(如“剪掉开头”、“去除停顿”、“加字幕”),AI 会自动调用相应的 video-tools MCP 工具完成编辑,并始终遵循“不修改原始文件、逐步骤操作、先画面后声音再导出”的原则。每次编辑后还会调用 video-qa 技能对最终文件进行质量检查。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/github774/claude-video-studio/tree/HEAD/plugins/video-studio/skills/video-edit

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

视频编辑

真实素材,确定性编辑,可验证输出。每一步操作都是一个 video-tools MCP 工具;直接调用它们,而不是手写 ffmpeg,这样路径、编码和响度始终正确。

基本原则

  • 绝不动原始文件。 写入到 video-out/<slug>/ 目录,按步骤编号命名(如 01_trim.mp4、02_jumpcut.mp4)。除非设置 overwrite=true,否则工具会拒绝覆盖。
  • 先查看再剪裁。 对每个源文件先使用 probe 和 contact_sheet。使用 detect 检测场景切点和静音段。如果需要字幕且已安装 watch 插件则使用它;否则提取音频为 .wav 并用现有的转写工具(whisper、用户可用的云 API)进行转写,同时说明所用的工具。
  • 每步只做一项修改,然后通过 contact_sheet 查看结果,再进行下一步。
  • 画面优先,声音其次,导出最后:裁剪 → 字幕 → 音乐 → 响度 → 导出。

标准流程

目标工具调用
查看probe(path, measure_loudness=true)、contact_sheet(input)、detect(input)
选择范围trim(input, output, start, end)(默认精确)
讲话视频收紧remove_silence(input, output, threshold_db=-35, min_silence=0.45, padding=0.12);对嘈杂房间将 threshold_db 升高到 -30,如果单词被剪掉则增加 padding
拼接concat(inputs, output, crossfade=0);不同尺寸/帧率/无音频的片段会自动适配
字幕根据转写结果编写 .srt 文件(每行最多约 32 字符,2 行,每段 1-6 秒),然后 `burn_captions(style=clean
音乐add_music(input, music, output, music_db=-16, duck=true);音乐会被循环、修剪、淡入淡出,并通过侧链压缩在语音下自动闪避
竖版 / 正方形`reframe(aspect="9:16", fit=blur
变速对裁剪后的片段执行 speed(factor),然后 concat
缩略图候选从 contact sheet 中选择 3-5 个精彩瞬间调用 frame(time)
仅响度normalize_audio(target_lufs=-14)
导出`export(preset=youtube

从长视频生成短视频

  1. detect + 转写 → 挑选一个 15-60 秒的片段,要求前 2 秒有吸引点且包含一个完整想法。
  2. trim → remove_silence → reframe 9:16 → burn_captions style=bold → export shorts。
  3. 如果用户需要更有力的开头,且已安装 viral-hook 技能,则提供该选项。

完成

始终对最终文件运行 video-qa 技能,匹配相应的目标平台。

相关技能