关于 editing-videos
面向 Agent 的视频剪辑技能,提供从规划到审核、发布的编辑指导。内容结合通用剪辑原则、不同视频类型的配方,以及带许可信息的音效和图形素材库。
主要功能
- 01按视频类型提供剪辑配方
- 02节奏、剪切、文字、音频与色彩指导
- 03审核与导出清单
- 04CC0 音效和图形素材库
- 05不含媒体的可搜索梗图索引
适用场景
- 01为特定受众和平台规划剪辑
- 02检查节奏、字幕、音频与色彩
- 03从长视频制作竖屏短片
- 04制作旁白式屏幕教程
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ kmilo93sd/ agent-video-editor --skill editing-videos安装后在 Claude Code 中输入/editing-videos确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
evals/evals.jsongraphics/build-preview.mjscatalog.jsoncheck.mjsLICENSES.mdpreview.htmlsearch.mjsgraphics/arrows/arrow-curved.htmlarrow-curved.svgarrow-hand-drawn.htmlarrow-hand-drawn.svgarrow-straight.htmlarrow-straight.svggraphics/callouts/callout-box.htmltooltip.htmlgraphics/cta/subscribe-prompt.htmlgraphics/focus/cursor-click-ripple.htmlcursor.svgspotlight-dim.htmlgraphics/highlights/box-highlight.htmlcircle-hand-drawn.htmlcircle-hand-drawn.svgring-highlight.htmlgraphics/layouts/before-after-split.htmlend-screen.htmlgraphics/overlays/film-grain.htmllight-leak.htmlgraphics/progress/countdown.htmlprogress-bar.htmlstep-counter.html详细介绍
编辑视频
这项技能体现了编辑的判断力:何时剪切、镜头或字幕持续多久、音乐音量多大、何时图形有帮助、何时会造成干扰。每个数字都会注明出处:官方(平台或供应商文档)、研究、创作者(没有公开数据的实践)或内部经验(从审看实际剪辑中总结)。内容分为两个层次:
- 核心内容(本文件、
references/和review-checklist.md):适用于任何视频和任何工具的剪辑技巧。 - 配方(
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)。
硬性规则(适用于任何视频、任何工具)
- 每个剪辑点都有理由:删去无效时间、改变信息或跟随动作。绝不剪在一个词的中间。
- 尽早兑现承诺。 标题和缩略图承诺的内容要在最初几秒内出现或说出;在此之前不要放 Logo 片头或问候语。
- 人声绝不与其他声音抢听感。 音乐音量比人声低 18–25 dB,并进行闪避;音效音量要低于人声,且绝不盖住关键词;每段空白处都要有室内底噪。
- 针对目标平台一次完成母带处理:YouTube 为综合响度 -14 LUFS、真峰值 ≤ -1 dBTP;播客订阅源为 -16 LKFS ± 1。必须测量,不可猜测。
- 图形绝不空置。 最多在提到它的词语前 0.5 秒出现,并在 1 秒内展示内容;每个元素出现时间与人声提到它的时间相差 ≤ 0.6 秒 [统一规范]。
- 文字要留足阅读时间:
max(1.5 s; words × 0.33 s + 0.5 s);字幕每行 ≤ 42 个字符、最多 2 行、每行至少显示 20 帧。 - 只有在内容有依据时才缩放和推近;画面要清晰,且绝不跨越剪辑点。
- 镜头要匹配:同一场景内的曝光、白平衡和音量保持一致。
- 仅使用已获授权的媒体:CC0、YouTube 音频库,或明确允许商业用途的书面许可。不得使用禁止商业用途(NC)的内容,也不得使用“在 YouTube 上找到的”内容。新加入素材库的音效须将授权凭证留在
library/LICENSES.md中。图形须来自graphics/(CC0)或附带已记录的许可。未经许可不得使用受版权保护的梗图、片段或音效:应自行重现笑点(memes/README.md)。 - 不得编造数字。 如果没有来源支持某个数字,就如实说明,并根据内容作出判断。
- 未经批准不得渲染或发布;任何剪辑都必须通过对应流程的检查清单和
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` |