mcpField
E
editing-videos

editing-videos

github.com/kmilo93sd创意与媒体670 次安装4 周前更新
代码仓库

关于 editing-videos

面向 Agent 的视频剪辑技能,提供从规划到审核、发布的编辑指导。内容结合通用剪辑原则、不同视频类型的配方,以及带许可信息的音效和图形素材库。

主要功能

  1. 01按视频类型提供剪辑配方
  2. 02节奏、剪切、文字、音频与色彩指导
  3. 03审核与导出清单
  4. 04CC0 音效和图形素材库
  5. 05不含媒体的可搜索梗图索引

适用场景

  1. 01为特定受众和平台规划剪辑
  2. 02检查节奏、字幕、音频与色彩
  3. 03从长视频制作竖屏短片
  4. 04制作旁白式屏幕教程

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/kmilo93sd/agent-video-editor --skill editing-videos

安装后在 Claude Code 中输入/editing-videos确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

evals/
evals.json
graphics/
build-preview.mjs
catalog.json
check.mjs
LICENSES.md
preview.html
search.mjs
graphics/arrows/
arrow-curved.html
arrow-curved.svg
arrow-hand-drawn.html
arrow-hand-drawn.svg
arrow-straight.html
arrow-straight.svg
graphics/callouts/
callout-box.html
tooltip.html
graphics/cta/
subscribe-prompt.html
graphics/focus/
cursor-click-ripple.html
cursor.svg
spotlight-dim.html
graphics/highlights/
box-highlight.html
circle-hand-drawn.html
circle-hand-drawn.svg
ring-highlight.html
graphics/layouts/
before-after-split.html
end-screen.html
graphics/overlays/
film-grain.html
light-leak.html
graphics/progress/
countdown.html
progress-bar.html
step-counter.html

详细介绍

编辑视频

这项技能体现了编辑的判断力:何时剪切、镜头或字幕持续多久、音乐音量多大、何时图形有帮助、何时会造成干扰。每个数字都会注明出处:官方(平台或供应商文档)、研究、创作者(没有公开数据的实践)或内部经验(从审看实际剪辑中总结)。内容分为两个层次:

  1. 核心内容(本文件、references/ 和 review-checklist.md):适用于任何视频和任何工具的剪辑技巧。
  2. 配方(recipes/):针对某种视频类型的不同之处。只加载匹配的配方。

这项技能不能替代工具。在操作机制方面(文件格式、API、渲染器的约定),以工具自身的文档或技能为准;在编辑方面,则以这项技能为准。references/tools.md 说明了如何将这些技巧应用到各个工具。

流程

#步骤内容阅读
1简报视频类型、受众、平台和格式(16:9 或 9:16)、时长、可用工具。选择配方下文的“选择配方”
2故事内容承诺(标题和缩略图构思),以及在开头几秒兑现承诺的钩子;各个部分或章节references/hook-and-retention.md
3组装选出最佳镜头并排好顺序;剪掉无效片段;暂不进行润色references/pacing-and-cuts.md、对应配方
4节奏根据视频类型确定镜头时长、J-cut 和 L-cut、跳切、补充镜头、推近references/pacing-and-cuts.md
5图形和文字只在有助于解释时使用图形;让文字与语音同步;添加字幕references/graphics-and-text.md、graphics/、memes/
6音频清理对话、房间底噪、人声下的音乐和音效,然后处理母带references/audio-and-sfx.md、library/
7色彩曝光、白平衡、镜头匹配;最后才应用风格化效果references/color.md
8审看先使用对应配方的检查清单,再使用核心检查清单;配合画面和耳机检查review-checklist.md
9导出仅在获得本人批准后进行:格式、响度母带处理、检查文件references/audio-and-sfx.md、references/tools.md
10发布标题、缩略图、描述、章节、字幕、署名references/thumbnail-title-description.md、references/licenses.md

如果 Agent 无法操作编辑器,仍应将步骤 1–8 转化为决策:编辑决策列表、标记列表、字幕文件和带具体数值的说明(references/tools.md)。

硬性规则(适用于任何视频、任何工具)

  1. 每个剪辑点都有理由:删去无效时间、改变信息或跟随动作。绝不剪在一个词的中间。
  2. 尽早兑现承诺。 标题和缩略图承诺的内容要在最初几秒内出现或说出;在此之前不要放 Logo 片头或问候语。
  3. 人声绝不与其他声音抢听感。 音乐音量比人声低 18–25 dB,并进行闪避;音效音量要低于人声,且绝不盖住关键词;每段空白处都要有室内底噪。
  4. 针对目标平台一次完成母带处理:YouTube 为综合响度 -14 LUFS、真峰值 ≤ -1 dBTP;播客订阅源为 -16 LKFS ± 1。必须测量,不可猜测。
  5. 图形绝不空置。 最多在提到它的词语前 0.5 秒出现,并在 1 秒内展示内容;每个元素出现时间与人声提到它的时间相差 ≤ 0.6 秒 [统一规范]。
  6. 文字要留足阅读时间:max(1.5 s; words × 0.33 s + 0.5 s);字幕每行 ≤ 42 个字符、最多 2 行、每行至少显示 20 帧。
  7. 只有在内容有依据时才缩放和推近;画面要清晰,且绝不跨越剪辑点。
  8. 镜头要匹配:同一场景内的曝光、白平衡和音量保持一致。
  9. 仅使用已获授权的媒体:CC0、YouTube 音频库,或明确允许商业用途的书面许可。不得使用禁止商业用途(NC)的内容,也不得使用“在 YouTube 上找到的”内容。新加入素材库的音效须将授权凭证留在 library/LICENSES.md 中。图形须来自 graphics/(CC0)或附带已记录的许可。未经许可不得使用受版权保护的梗图、片段或音效:应自行重现笑点(memes/README.md)。
  10. 不得编造数字。 如果没有来源支持某个数字,就如实说明,并根据内容作出判断。
  11. 未经批准不得渲染或发布;任何剪辑都必须通过对应流程的检查清单和 review-checklist.md,否则不得展示。

选择对应流程

视频类型流程在核心规则基础上增加的内容
一人对镜头讲话recipes/talking-head.md删除填充词、弱化跳切、推近、在讲述内容上叠加 B-roll
一天的生活、一次旅行或一场活动recipes/vlog.md寻找故事线、冷开场、镜头序列、风声和现场音频、匹配多台摄像机
多机位对话recipes/podcast-to-youtube.md同步、切换机位、开放麦克风、播客母带、按主题分章节
从长视频剪出的竖屏片段recipes/shorts-from-long-form.md选取片段、重新构图为 9:16、烧录字幕、循环播放
配有旁白的软件教程(屏幕录制)recipes/narrated-screen-tutorial.md以屏幕内容为主、如实控制播放速度、演示数据、合成语音、章节卡片;经过测试的模板(Playwright、ElevenLabs、HyperFrames)
其他类型(讲解、随笔、评测等)无遵循核心规则:节奏表按类型列有对应条目;参考最接近的流程

节奏速览

完整表格及每个数字的来源见 references/pacing-and-cuts.md。

类型画面内容变化频率语句间停顿
对镜头讲话每 2–5 秒(创作者经验)200–400 毫秒(创作者经验)
Vlog随事件变化;电影中平均每个镜头约 4–5 秒(研究数据)自然停顿,并保留室内底噪
讲解视频25–35 秒时首次打断,此后每 2–3 分钟一次(创作者经验)200–400 毫秒(创作者经验)
屏幕教程动作改变时;镜头 ≥ 5 秒(统一规范)≥ 0.4 秒(统一规范)
播客/访谈在说话者切换和出现反应时;没有频率方面的来源保留自然停顿
短视频/Reel/TikTok每 2–3 秒一次;每 5–7 秒出现新内容(创作者经验)200–300 毫秒(创作者经验)
## 音频速览
  • 母带:YouTube 使用 -14 LUFS、≤ -1 dBTP;以 48 kHz 上传 AAC。
  • 音乐:音量比人声低 18–25 dB,有人说话时再降低 6–12 dB。
  • 音效:音量比人声低 12–24 dB,每个屏幕事件配一个音效,并将瞬态提前 2–4 帧。
  • 根据测量电平计算增益:gain = 10^((voice_lufs - under_voice - sound_lufs)/20),上限为 1。

CC0 音效库

library/ 中包含 128 个 CC0 文件,每个文件都测量了 LUFS 和真峰值:113 个音效(单声道 WAV,48 kHz, -22 LUFS)和 15 首音乐曲目(立体声 MP3,48 kHz,-16 LUFS)。分类:转场 18 个、点击 12 个、出现 12 个、通知 11 个、成功 7 个、错误 5 个、打字 9 个、冲击 5 个、点题音 14 个、办公室 17 个、环境音 3 个、音乐 15 首。 以下路径均相对于此技能的文件夹(例如 ~/.claude/skills/editing-videos/)。

node library/search.mjs                          # categories
node library/search.mjs --category transition
node library/search.mjs whoosh --paths           # paths to copy
node library/search.mjs pop --voice -17          # with the gain for a voice at -17 LUFS

--voice 会将音效设为比人声低 15 dB、音乐低 20 dB、环境音低 30 dB。请将文件复制到视频 项目中;不要从项目外部链接这些文件。许可证和来源:library/LICENSES.md 和 references/licenses.md。添加音效后,运行 node library/verify.mjs。

图形素材包(CC0)

graphics/ 包含 26 个可直接用于 HyperFrames 的图形:箭头、圆圈和高亮环、下划线和 涂鸦、聚光灯、光标点击涟漪、标注和工具提示、下三分之一字幕、键帽标记、步骤计数器、进度条、倒计时、 对勾和叉号、前后对比分屏、章节卡片、结束画面布局、漏光和颗粒叠加效果,以及通用的点赞和订阅提示。每个素材都是 HTML 片段(形状另附 SVG):包含定时 .clip、通过 --gfx-* 自定义属性设置的颜色和大小,以及 gfx.<name>(tl, el, opts) 函数,可将支持定位的补间动画添加到合成的时间线上。将 at 锚定到 指出目标的词语;catalog.json 会列出每个素材的时长以及不适用的场景。

node graphics/search.mjs                         # categories
node graphics/search.mjs --category arrows
node graphics/search.mjs shortcut --paths        # paths to copy

打开 graphics/preview.html 查看所有素材的动画效果。添加素材后,运行 node graphics/build-preview.mjs 和 node graphics/check.mjs。

表情包

memes/catalog.json 是一份包含 59 个表情包及其格式的参考资料,不含媒体文件:介绍每个表情包的含义、适用于教程的场景、在屏幕上的显示时长、如何使用 graphics/ 复刻、原始内容的所有者及其 Content ID 风险。请复刻笑点或取得原始内容的授权;切勿使用表情包中的音乐。请先阅读 memes/README.md。

node memes/search.mjs fail --risk low
```</source>
## 索引

| 文件 | 内容 |
|---|---|
| `references/pacing-and-cuts.md` | 按视频类型划分的节奏表及来源;剪辑的用途;镜头时长;J-cut 和 L-cut;跳切;B-roll;转场;分段 |
| `references/hook-and-retention.md` | YouTube 如何衡量留存率;不同类型的钩子;开放式悬念;章节;结束画面和收尾 |
| `references/graphics-and-text.md` | 何时使用图形;锚定位置,绝不留空;文字显示时长;字幕;缩放和快速推近;入场动画;安全区域;易读性 |
| `references/audio-and-sfx.md` | 目标音量;对白清理;房间底噪;音乐和自动闪避;增益计算;音效;母带处理 |
| `references/color.md` | 工作顺序;将 LUT 作为起点;匹配镜头;SDR 和 HDR 交付 |
| `references/thumbnail-title-description.md` | 缩略图规格和实践、A/B 测试、标题、描述、话题标签、章节 |
| `references/licenses.md` | 适用于营利频道的音乐、音效和素材来源;合理使用;Content ID |
| `references/tools.md` | 在 NLE 中应用这些技巧(EDL、标记、字幕、说明)、ffmpeg、Remotion 和 HyperFrames |
| `review-checklist.md` | 通用审核:发布前的测量、目视检查和听觉检查 |
| `recipes/talking-head.md` | 对镜讲述视频的制作流程和检查清单 |
| `recipes/vlog.md` | Vlog 的制作流程和检查清单 |
| `recipes/podcast-to-youtube.md` | 播客和访谈(多机位)的制作流程和检查清单 |
| `recipes/shorts-from-long-form.md` | 从长视频制作竖屏片段:制作流程和检查清单 |
| `recipes/narrated-screen-tutorial.md` | 旁白屏幕教程的制作流程、规范、流程和检查清单 |
| `recipes/narrated-screen-tutorial/voice.md` | 教程的脚本和合成语音:语音缩写(西班牙语旁白)、ElevenLabs、各章节的 LUFS、whisper |
| `recipes/narrated-screen-tutorial/hyperframes-generator.md` | 在 HyperFrames 中剪辑教程:每个步骤的技能、规范中的规则、生成器及其检查、注意事项、审核循环 |
| `recipes/narrated-screen-tutorial/templates/` | 适用于该流水线且经过测试的模板;每个模板都支持 `--help` |
| `library/` | CC0 音效:`catalog.json`、`search.mjs`、`verify.mjs`、`LICENSES.md`、`sfx/`、`music/`、`tools/synthesize.py` |
| `graphics/` | CC0 HyperFrames 图形:`catalog.json`、`search.mjs`、`preview.html`、`check.mjs`、`LICENSES.md`、按类别划分的文件夹 |
| `memes/` | 不包含媒体文件的 Meme 参考:`README.md`(请先阅读)、`catalog.json`、`search.mjs` |

评论

支持 Markdown