把一句话灵感、粗略大纲或参考剧本，稳定生成中文竖屏短剧的大纲、正文、续写、改写、质检报告和
.txt/ PDF 剧本文档。
短剧创作最容易卡在三件事：开头不够抓人、正文格式乱、爽点和钩子断掉。这个 skill 把中文微短剧常见的高转化叙事、前 3 集强开局、分集节奏、行级剧本标记和质量自检收进一个可复用工作流。
它不绑定某个题材。你可以写荒年穿越、都市爱情、黑帮双身份、美食综艺、银发逆袭、品牌文旅、海外竖屏，也可以按参考剧本的格式写一个完全不同的新故事。
npx skills add joeseesun/qiaomu-drama-generator验证：
ls ~/.agents/skills/qiaomu-drama-generator- “荒年穿越，带系统，全家致富，写一个 20 集短剧。”
- “帮我把这个大纲改成更像短剧的版本，前三集要强钩子。”
- “按参考文档的格式，写一个现代爱情短剧 txt 剧本文档。”
- “检查这个剧本有没有爽点、钩子和可拍摄性问题。”
- “写一个海外 ReelShort 风格的契约婚姻短剧。”
- 判断任务类型：一句话主题、限制生成、大纲转正文、续写、改写、质检、海外竖屏或品牌短剧。
- 自动补齐目标观众、主爽点、标题、人物关系、反派阶梯、金手指或核心能力。
- 按短剧节奏设计前 3 集强开局和 20 / 60 / 100 集结构。
- 按严格剧本标记输出正文：
一、剧本 / 二、正文剧本 / 第 N 集 / N-M 场景 / 人物： / OS / VO / 字幕 / 系统面板。 - 根据需要生成
.txt剧本文档，用户明确要求时可导出 PDF。 - 用格式、节奏、爽点、钩子、可拍摄性和合规边界做自检。
《剧名》
一、剧本
[项目简介]
二、正文剧本
剧名
第 1 集
1-1 场景名 日内
人物：人物甲，人物乙
△ 关键动作。
人物甲（状态）：对白。
人物乙（OS）：内心独白。
【字幕：关键信息】
- 已安装支持 skills 的 agent 运行环境。
- 如需从 GitHub 安装：Node.js 和
npx可用。 - 如需发布或二次开发：GitHub CLI 可用，并已登录。
验证命令：
node --version
npx --version
gh auth status不需要环境变量。这个 skill 默认只生成文本和本地文件，不调用外部付费 API。
- 参考剧本只复用格式和写法，不复制原人物、原剧情或连续台词。
- 强冲突可以写，但不输出低俗擦边、恶意猎奇、未成年人不当情节或真实人物造谣。
- 复仇要靠证据、法律、公开真相、商业反击或正当防卫。
- 品牌短剧要让产品自然参与剧情，不夸大功效，不硬塞口播。
| 问题 | 原因 | 解决 |
|---|---|---|
| 生成内容像小说，不像剧本 | 没有触发严格标记格式 | 明确说“按参考文档格式写正文剧本” |
场景缺少 人物： |
输出被压缩或续写时格式漂移 | 让 agent 使用 scripts/validate_script_format.py 校验 .txt |
| 安装后找不到 skill | skills 安装目录不同 | 检查 ~/.agents/skills/qiaomu-drama-generator |
npx skills add 失败 |
Node.js、网络或 GitHub 权限问题 | 先运行 node --version、npx --version，再检查 GitHub 可访问性 |
SKILL.md
agents/interface.yaml
references/task-router.md
references/generation-rules.md
references/genre-engines.md
references/output-format.md
references/script-format-spec.md
references/quality-and-boundaries.md
scripts/validate_script_format.py
格式规范来自中文短剧制作实践和用户提供的参考剧本文档；skill 包装流程参考 Qiaomu Meta Skill 的发布约定。
MIT