mcpField
V
video-script

video-script

github.com/melvynx营销与增长6949 次安装1 周前更新
代码仓库

关于 video-script

面向创作者的视频脚本技能,可依据真实经历和个人表达风格,生成短视频脚本、钩子、改写稿或自然化文本。它结合领域研究、账号数据和使用记录来规划内容,并避免重复近期主题。

主要功能

  1. 01规划一周不同类型的视频脚本
  2. 02生成并评分多个开场钩子
  3. 03改写脚本并检查时长
  4. 04让文本贴合创作者的表达风格
  5. 05依据研究和记录规划选题

适用场景

  1. 01规划一周的短视频内容
  2. 02根据已验证的领域概念生成钩子
  3. 03在不改变事实的前提下精简草稿
  4. 04让说明文字更贴近创作者口吻

安装

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

$npx skills add https://github.com/melvynx/video-agent-skills --skill video-script

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

包含的文件

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

references/
ai-tells.md
hooks.md
humanize.md
script-rules.md
viral.md

详细介绍

视频脚本

写出创作者状态最佳时的口吻:简短、具体,并用一个能让观众继续看接下来 30 秒的钩子。所有内容都来自他们真实的一周和他们自己的表达。绝不编造。

开始写作前

按以下顺序阅读:

  1. video-agent/voice.md:他们是谁、与谁交流、表达风格、信念、证据和行动号召。若缺少该文件:提供 /video-setup(约 10 分钟,推荐),或现在就问 4 个问题(他们做什么、服务对象是谁、录制时使用什么语言、希望观众看完后做什么)。
  2. video-agent/swipe.md:在他们所在领域奏效的钩子,以及其上的“概念”(Concepts)——那些表现超出预期且有证据支撑的概念(来自 /video-viral)。每个脚本都以其中一个为基础(references/viral.md)。若缺少该文件:先运行 /video-viral(5 分钟);不做这一步就写一周的脚本,无异于盲写。
  3. 如果存在,阅读 video-agent/audit.md:他们自己的账号上哪些内容有效(来自 /video-audit)。“下周的 3 项调整”适用于本周的脚本,表现最佳的主题、长度和钩子公式优先。他们自己的数据胜过整个领域的数据。
  4. 阅读 video-agent/log.md 最后 20 行:已经用过的主题和钩子公式。除非他们提出要求,否则绝不重复过去 4 周内用过的主题。
  5. references/viral.md、references/hooks.md、references/script-rules.md 和 references/humanize.md。

用他们使用的语言与他们交流,并用他们录制视频时使用的语言撰写脚本。

模式

  • /video-script → 一周的脚本(默认 5 个)。
  • /video-script <topic or idea> → 一个脚本。
  • /video-script hook <script or topic> → 钩子生成器:生成 20 个钩子,使用至少 10 种公式,按 swipe.md 中的概念分组(有证据的概念优先),并结合 voice.md 中的内容(观众的用词、他们的表达、证据、误区);为钩子评分并通过质量检查,最佳的 3 个排在最前。每个钩子都保留其公式名称,这样有效的钩子就能换种表达后重新发布。
  • /video-script rewrite <script> → 优化他们的脚本:内容和事实不变,改进钩子、缩短句子、检查时长并让表达更自然。说明改动之处。
  • /video-script humanize <file, script slug or pasted text> → 将任意文本(脚本、配文、描述、帖子)改写成符合他们风格的表达:references/humanize.md,并提供改写前后的评分。humanize check 只提供检查结果。

对于 hook 和 humanize,跳过“本周内容”和“内容组合”:阅读 voice.md 和参考文件后,只完成对应任务。

1. 本周内容

只问一个问题:“这周实际发生了什么?” 提供一些提示,方便他们回答:一个结果(带数字)、一次失误、客户或粉丝提出的问题、学到或测试的东西、用过的工具、交谈中出现的观点、不同意的说法。

只要符合有证据的概念,真实素材就胜过创意。然后查看今天该领域的热点(发布动态、趋势、本周的价格变动):本周的第一个脚本要紧跟其中一项热点。要是他们没有素材,就根据 voice.md(信念、观众常犯的错误、证据)、audit.md(他们表现超出预期的主题)和 swipe.md 提出 5 个主题,让他们选择。

然后询问:要制作多少条视频(默认 5 条),以及本周是否有要推广的内容(有 → 制作一条推广视频;没有 → 不制作)。

2. 内容组合

为每条视频指定一种类型。动笔前先规划一周:

类型作用每周 5 条视频的默认数量
教学一个问题,以及观众今天就能用上的一个解决办法2
证明一个真实结果,以及促成它的因素1
故事一个瞬间、一次转折、一条经验1
观点挑战该细分领域常见建议的立场1
推广问题、为解决问题做出的东西、适用对象、行动请求0 或 1,绝不超过 2

每条视频还要标注其推广距离,即它对应 voice.md「The ask」中的第几级(0 至 3,见 script-rules.md),并遵循其中的每周组合安排。

用表格展示计划(编号、类型、主题、概念、打算先尝试的钩子公式、推广距离),并在动笔前让对方调整。连续两条视频绝不使用相同的钩子公式,一周内同一类型绝不出现三次。

3. 撰写每条脚本

  1. 目标:说明它依托 swipe.md 中的哪个概念(包括最适合的视频及其 x)、是否有新近消息、面向哪类观众、要打破的错误观念或迷思(voice.md),以及对应级别的行动请求。
  2. 3 个钩子:分别使用 hooks.md 中不同的公式。按 script-rules.md 的评分标准给每个钩子评分。保留最佳钩子,另外两个放在「Other hooks」下。如果都低于 7/10,再写 3 个。
  3. 屏幕钩子:不超过 6 个词,在最初几秒内显示。它要补充口播钩子,而不是逐字重复。
  4. 正文:按照对应类型的结构撰写(script-rules.md)。每行一句。在中段附近设置一个重新吸引注意力的钩子。
  5. 结尾:说出 voice.md 中的行动请求,仅说一次;或者用最后一句衔接开头,形成循环。
  6. 视觉说明:与口播内容分开,说明要展示什么,以及值得用作屏幕提示的 1 至 4 个词(数字、结果、工具名称)。
  7. 时长:统计字数,按语速换算(voice.md 中的语速,否则按每分钟 160 词)。检查 script-rules.md 中的每条节奏规则。展示前修改。
  8. 事实:每个数字、名称和结果都必须来自 voice.md 或对方提供的信息。其他内容替换为 {{your number}}、{{client name}},并列在「To fill」下。
  9. 自然化:按照 references/humanize.md 对脚本进行处理(步骤 1 至 6,每条脚本不附报告)。大声读一遍。不得出现对方绝不会说的话(voice.md「Words I never use」),不得使用长破折号,不得带有 AI 腔调,同时保留所有事实。将评分填入脚本的 Score 行。
  10. 触发因素与质量关卡:在对应位置至少加入 script-rules.md 中的四个触发因素,然后通过四项质量关卡(通用、缺乏结构、可互换、追求病毒式传播)。未通过任一关卡,就必须先重写再展示。

4. 格式

保存到 video-agent/scripts/week-YYYY-MM-DD.md(该周的星期一)。每周一个文件;单条脚本也放入当周文件。

# Week of 2026-10-05

| # | Slug | Type | Formula | Offer | Length |
|---|---|---|---|---|---|
| 1 | hooks-too-long | Teach | The mistake | 0 | 40 s |

## 1. hooks-too-long

**On screen:** Your hook is *too long*
**Hook:** Your first sentence has 20 words. Nobody hears word 12.

```script
Your first sentence has 20 words. Nobody hears word 12.
By then, most people already swiped.
I checked my last {{number}} shorts.
The ones that held past 3 seconds had short hooks.
Under 12 words, with the topic in the first 5.
Here's the part everyone skips.
Cutting is easy, picking the one point is the hard part.
So write your hook, then cross out everything before the point.
"In this video I'll show you how to write better hooks."
Becomes: "Your hook is too long."
Same idea, half the words, and it lands before they swipe.
Try it on your next three videos.
Follow for one script fix a day.
```

**Visual notes**
- line 1 → callout: 20
- line 5 → callout: 12 words
- line 9 → show: the long hook, crossed out

**Ask:** Follow for one script fix a day.

**Other hooks**
- (Stop / start) Stop explaining in your hook. Start with the result.
- (Their words) "My hook is fine, it's the algorithm."

**Triggers:** gap 0s, self-recognition 0s, proof 6s, pattern break 20s, specificity 28s
**Score:** hook 8/10 · human 10/10 · 111 words · 40 s at 165 wpm · offer 0 · gates ✓
**To fill:** {{number}}

script 区块只能包含口播台词:创作者录制时照着读,video-edit 则根据它来剪辑。

然后展示 READY 摘要并等待:

READY · week of 2026-10-05 · 5 scripts (Teach, Proof, Story, Opinion, Teach) · 38 to 52 s
Saved: video-agent/scripts/week-2026-10-05.md
To fill: 3 placeholders
Reply yes to log them, or tell me what to change.

对方确认后,为每条脚本在 video-agent/log.md 中添加一行:

2026-10-05 | hooks-too-long | Teach | The mistake | why long hooks lose viewers

5. 交接

展示当周的表格和第一条脚本的完整内容,然后询问要修改什么。接下来的步骤:录制每条脚本(使用手机、摄像机或网络摄像头,每条脚本一镜到底,保存到 video-agent/takes/<slug>.mp4),然后运行 /video-edit <slug>,再运行 /video-publish <slug>。

诚实说明

  • 优秀的脚本不保证获得观看量。主题、时机、表达和运气同样重要。
  • 钩子评分是写作检查清单,不是预测。
  • 只有当 voice.md 收录了创作者真实说过的话时,脚本才会听起来像创作者。语音文件内容太少会导致脚本泛泛而谈:请更新它。

评论

支持 Markdown