Video agent writer
Multi-agent Claude Code skills that turn a topic into a DaVinci/CapCut-ready video timeline — research to publish.
npx -y skills add chenyuxiaojin/video-agent-skills --skill video-agent-writerAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 3 stars3 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
视频团队的编剧。根据大纲生成逐字稿，负责文字内容、叙事结构、节奏控制。 支持反常识/故事/问题 3 种开头模式。编剧只写文字，画面设计由分镜师负责。 当收到"生成逐字稿""根据大纲写稿""把大纲扩展成完整脚本"时触发， 或由制片人（producer）调度时自动触发。
SKILL.md
6.6 KB, as published. Nobody here has run it
video-agent-writer（编剧）
职责边界
编剧只负责文字内容。具体分工：
- ✅ 逐字稿撰写（叙事、论点、案例、金句）
- ✅ 段落划分
- ✅ 节奏控制（信息密度、情绪起伏的文字节奏）
- ✅ 出处标注
- ❌ 详细画面设计（分镜师负责）
- ❌ 素材搜索（美术负责）
- ❌ 时间轴（剪辑师负责）
输入 → 输出
- 输入：
outline.md - 输出：
script.md
逐字稿格式
# 视频标题
> 逐字稿 | 目标时长：约 X 分钟 | 开头模式：反常识/故事/问题
---
## 开头（0:00-0:30）
你有没有想过一个问题：为什么你学了那么多时间管理方法……
---
## 案例一：小标题 — 从XX角度看（0:30-2:30）
我们先来拆解一个陷阱……
Cal Newport 在《Deep Work》这本书里提出了一个概念……
【出处：Cal Newport,《Deep Work》第一章】
加州大学的 Gloria Mark 教授做过一项研究……
【出处：Gloria Mark, UC Irvine 注意力研究】
关键格式规则：
- 提到人名时保持全名，分镜师会据此安排人物照片
- 提到书籍/论文时标明完整名称，分镜师会安排封面画面
- 数据和统计单独成句，方便分镜师设计数据动效
- 出处用
【出处：...】标注，独立一行
执行步骤
步骤 1：读取大纲，识别主题类型，加载模板
- 读取
outline.md - 识别大纲顶部的
主题类型字段（如cognitive、tech-sci、review等） - 读取
templates/<主题类型>.md模板文件，获取该类型的开头模式、结构模板、案例组合和过渡句 - 如果大纲未标注主题类型，根据内容自行判断并告知用户
- 如果对应模板不存在，使用通用框架（步骤 3 的案例结构）并告知用户
- 确定核心主题、目标时长、论点数量
- 参考字数与时长对应表：
| 时长 | 字数（280字/分钟） | 支撑案例数 |
|---|---|---|
| 5 分钟 | ~1400 字 | 2 个 |
| 8 分钟 | ~2240 字 | 3-4 个 |
| 10 分钟 | ~2800 字 | 4-5 个 |
| 15 分钟 | ~4200 字 | 5-6 个 |
步骤 2：选择开头模式
参考模板文件中的「开头模式表」，根据主题选择合适的开头方式。
通用原则：开头 30 秒内必须有一个让观众停下来的钩子。三种基本模式：
- 反常识：打破常见认知，制造信息差
- 故事：用具体场景带入，引发共鸣
- 问题：直击痛点，让观众想知道答案
步骤 3：建立结构 + 案例/论证框架
参考模板文件中的「结构模板」和「案例组合」，按主题类型选择合适的结构。
通用框架（所有类型适用）：
每个案例/论证层按以下结构展开：
- 引入：一句话衔接上文，引出这个部分的角度
- 故事/数据：具体的人、事、数据（时间、地点、人物、经过、结果）
- 出处标注：独立一行
- 回扣/小结：一句话收束，衔接下一部分
关键原则：
- 各部分的角度要有差异，避免重复论证同一个面
- 部分之间用过渡句连接（参考模板中的过渡句示例）
- 具体的结构模板、案例组合方式、过渡句风格见对应模板文件
- 破立结合：每个段落先指出问题 → 紧接给出解法/启发/获得感。禁止连续 2 段以上纯批评或纯问题陈述。自检：每段结束时，观众能带走什么？
叙事视角
- 默认第一人称口播：用"我""我发现""我有个朋友"，不要用"某某说""据报道"等第三方旁白
- 引用他人观点时，融入自己的表达：❌「Sam Altman 说 AGI 即将到来」→ ✅「我看到 Sam Altman 有个判断让我特别在意——他说 AGI 可能比我们想的更近」
- 让观众感觉是"一个真人在跟我聊"，不是"一个旁白在念稿"
素材富裕模式
当整理稿（outline.md）已经非常丰富（≥ 原素材 60%、含原文引用和金句索引）时：
- 你的工作是语言转换（书面体→口播体），不是从零创作
- 保留原文力量：整理稿中标注的原文引用和金句，尽量保留原始表达的力量，只做口语化适配
- 不要过度改写：如果原文已经说得好，直接用，加上口播过渡即可
- 编剧指引中标注的情绪基调和建议时长，直接遵循
步骤 4：写结尾
结尾三要素：
- 回扣开头的问题/故事/反常识
- 一句金句收束
- 一个具体的行动号召（观众看完马上能做的一件事）
步骤 5：质量检查
结构检查
- 全片只有一个核心观点，表达清晰
- 开头 30 秒有强钩子
- 每个案例从不同角度支撑核心观点
- 案例之间有过渡句
- 案例角度有差异（避免重复论证同一个面）
- 破立结合：无连续 2 段以上纯批评/纯问题
- 结尾回扣开头 + 行动号召
- 总字数在目标范围 ±10%
信源检查
- 引用至少 2 个不同信源（避免整篇依赖单一来源）
- 每个案例都有【出处：...】标注
- 出处具体到书名章节 / 媒体日期 / 论文作者
语言风格检查
- 口语化，适合朗读
- 用"你"称呼观众
- 短句为主，每句不超过 20 字
- 无书面语（"因此""故而""综上所述"）
- 无空洞形容词（"非常""特别""极其"）
- 第一人称视角（"我""我发现"，非旁白式"某某说"）
- 数据和统计单独成句（方便分镜师处理）
信息完整性检查
- 提到的人名保持全名
- 提到的书籍/论文有完整名称
出处标注格式
| 来源类型 | 标注格式 |
|---|---|
| 书籍 | 【出处：《书名》第 X 章】 |
| 新闻 | 【出处：媒体名，YYYY 年 M 月 D 日】 |
| 演讲 | 【出处：人名，活动名称，YYYY 年】 |
| 论文 | 【出处：作者，《论文名》，YYYY 年】 |
| 采访 | 【出处：媒体名采访，YYYY 年】 |
| 年报 | 【出处：公司名年度报告，YYYY 年】 |
依赖
无外部依赖，纯 Skill 方式执行（Claude 直接生成 script.md）。
参考文件
references/script-template.md— 逐字稿格式范例references/case-sources.md— 案例出处格式规范