mcpField
S
studio-script

studio-script

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

关于 studio-script

studio-script 是帮助创作者用自己的表达方式撰写短视频脚本的 video-agent 技能。它依据创作者提供的素材和参考文件规划脚本、钩子、改写及领域研究,不虚构事实。

主要功能

  1. 01规划一周的视频脚本
  2. 02生成并评估钩子选项
  3. 03撰写漏斗式和幕后故事脚本
  4. 04改写文本并调整为创作者口吻
  5. 05研究领域内表现突出的短视频

适用场景

  1. 01规划一周的短视频内容
  2. 02按创作者口吻改写草稿
  3. 03查找领域内的钩子模式

安装

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

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

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

包含的文件

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

references/
ai-tells.md
funnel.md
hooks.md
humanize.md
making-of.md
script-rules.md
viral-research.md
viral.md

详细介绍

Studio Script

创作出创作者状态最佳时的脚本:简短、具体,开头钩子能让观众愿意再看 30 秒。一切内容都来自他们真实的一周和他们自己的表达,不虚构任何内容。

开始写之前

按以下顺序阅读:

  1. video-agent/voice.md:他们是谁、他们对谁说话、表达风格如何、相信什么、有哪些证明、希望观众采取什么行动。缺少该文件:运行 /studio-setup(约 10 分钟,推荐),或现在询问 4 个问题(他们做什么、服务谁、录制时使用什么语言、希望观众看完后做什么)。
  2. video-agent/swipe.md:在其细分领域表现出色的钩子,以及顶部的“Concepts”——即表现超出预期且有数据佐证的内容(来自 /studio-script viral)。每个脚本都基于其中一个内容概念(references/viral.md)。缺少该文件:先运行 /studio-script viral(5 分钟);没有它就写一周的脚本,无异于盲写。
  3. 如果存在,阅读 video-agent/audit.md:他们自己的账号上哪些内容有效(来自 /insta-audit)。其中的“3 changes for next week”适用于本周脚本;表现最好的主题、时长和钩子公式优先。他们自己的数据胜过细分领域的数据。
  4. 阅读 video-agent/log.md 最后的 20 行:已经用过的主题和钩子公式。除非他们提出要求,否则绝不重复过去 4 周内用过的主题。
  5. 阅读 references/viral.md、references/hooks.md、references/script-rules.md、references/funnel.md(触达新观众的视频就是漏斗)、references/making-of.md(创作者亲历的证明类和故事类视频就是幕后制作),以及 references/humanize.md。

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

模式

  • /studio-script → 一周的脚本(默认 5 篇)。
  • /studio-script <topic or idea> → 一篇脚本。
  • /studio-script funnel <topic> → 一篇漏斗脚本(references/funnel.md):从一个宽泛入口开始(通常是细分领域受众本就争论不休的有争议观点),然后依次展开桥接、张力、转折、收束到创作者细分领域的精华观点,以及轻柔的行动引导。给出 3 个桥接方案,并按入口的受众范围评分;先写精华观点;在备注行写出两个拓宽测试。
  • /studio-script making-of <what you did> → 一篇幕后制作脚本(references/making-of.md):围绕创作者做过的事和真实结果,按 4 个节拍展开(背景、行动、数字化结果、寓意),最后才给建议。还没有结果 = 系列第 1 集。
  • /studio-script hook <script or topic> → 钩子生成器:生成 20 个钩子,至少使用 10 种公式,按 swipe.md 中的内容概念分组(已验证的概念优先),结合 voice.md 的内容填充(观众的用词、他们的表达、他们的证明、他们的误区),评分、通过质量关卡,并将最佳 3 个放在最前面。每个钩子都保留其公式名称,这样有效的钩子就能换一种表述重新发布。
  • /studio-script rewrite <script> → 收紧他们的脚本:内容和事实不变,优化钩子、缩短句子、检查时长并让表达更自然。说明改动之处。
  • /studio-script viral [@handles or niche keywords] → 有数据衡量其细分领域中哪些内容表现超出预期:统计 10 到 12 个账号近期的 Shorts,并与各账号的中位数对比评分;分析每个异常值视频的前 3 秒、钩子公式,以及 video-agent/swipe.md 顶部的内容概念(references/viral-research.md)。约 5 分钟,每月运行一次。
  • /studio-script humanize <file, script slug or pasted text> → 将任意文本(脚本、说明文字、描述、帖子)改写得更像他们的表达风格:遵循 references/humanize.md,并提供改写前后的评分。humanize check 只生成报告。

对于 hook、humanize 和 viral,跳过“The week”和“The mix”:阅读 voice.md 和参考资料,然后只执行对应任务。

1. 本周

问一个问题:“这周实际发生了什么?” 提供提示,让他们更容易回答:一个成果(附上数字)、一次失误、客户或关注者提出的问题、他们学到或测试的东西、用过的工具、对话中出现的看法、他们不同意的观点。

只要符合经过验证的概念,真实素材就胜过点子。然后查看今天这个细分领域的热门话题(新品发布、趋势、本周价格变动):用一个脚本蹭上热度,排在本周第一条。如果他们没有素材,就从 voice.md(信念、观众会犯的错误、证据)、audit.md(表现超出预期的话题)和 swipe.md 中提出 5 个主题,让他们挑选。

接着问:要做多少条视频(默认 5 条),本周有没有要推广的内容(有 → 一条 Offer 视频;没有 → 不做)。

2. 内容搭配

每条视频都要设定类型。先规划一周,再开始写作:

类型作用每周 5 条时的默认数量
Teach一个问题,以及观众今天就能用上的一个解决方法2
Proof一个真实成果,以及促成它的原因1
Story一个时刻、一次转折、一个教训1
Opinion反驳该细分领域常见建议的立场1
Offer问题、为解决问题制作的内容、适用对象、行动号召0 或 1,绝不做 2 条

旨在触达新观众的 Teach 或 Opinion,要按照漏斗结构撰写(references/funnel.md);创作者亲身经历的 Proof 或 Story,则按幕后制作过程撰写(references/making-of.md)。

每条视频还要标注其与 Offer 的距离,即它指向 voice.md 中“The ask”的哪一阶(0 到 3,见 script-rules.md),并遵循其中的每周搭配规则。

用表格展示计划(编号、类型、主题、概念、准备先尝试的开场钩子公式、与 Offer 的距离),让他们在你开始写作前调整。连续两条不能使用相同的开场钩子公式,一周内同一类型不能出现三次。

3. 撰写每条脚本

  1. 目标:说明它借鉴了 swipe.md 中的哪个概念(包括该概念表现最好的视频及其 x)、可能有的话题新讯息、面向的观众、它要打破的错误信念或迷思(voice.md),以及对应阶层的行动号召。
  2. 3 个开场钩子,每个都采用 hooks.md 中不同的公式。用 script-rules.md 中的评分标准给每个打分。保留最佳的一个,另外两个放在“其他开场钩子”下。若全都低于 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}},并列在“待补充”下。
  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 → board: 20
- line 5 → board: 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 代码块中仅包含口播台词:创作者录制时照着念,短视频剪辑时也会用它来剪辑。

然后显示 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),然后执行 /short-editing <slug>,再执行 /publish <slug>。

诚实说明

  • 优秀的脚本并不保证获得播放量。主题、时机、表达和运气同样重要。
  • 开场吸引力评分是一份写作检查清单,而非预测。
  • 只有当 voice.md 中包含创作者真实说过的话时,脚本听起来才会像创作者。内容单薄的语音文件会生成通用脚本:请更新它。

评论

支持 Markdown