screenwriting-skills:让 Claude Code 学会专业编剧的 Agent Skill 包
screenwriting-skills:让 AI 学会专业编剧的 Agent Skill
功能与原则
screenwriting-skills 是一套专为 AI 编程助手设计的编剧技能包,以 SKILL.md 文件为载体,把人类数十年积累的剧作知识注入 Claude Code、OpenAI Codex 等 Agent 的上下文。它不是让 AI 写一段对白,而是让 AI 真正理解结构、人物、节奏、场景等专业编剧思维——24 个技能覆盖从项目规划到分镜输出的完整工作流,原则是”一次安装、跨语言输出、专业深度不打折”。
认可度
GitHub 斩获 619 颗星(截至 2026-09-13),增长曲线陡峭:9 月 7 日约 300 星,9 月 10 日 538 星,9 月 13 日已达 619 星,4 天内翻了一倍。Skilld.dev 平台统计安装量 388 次,claudepluginhub.com 平台获 388 关注,在 GitHub Trending 编剧类目下热度持续攀升。
链接
GitHub:https://github.com/jtydhr88/screenwriting-skills
原作者
GitHub 用户 @jtydhr88,独立开发者。该项目源自其个人对剧作的系统性研究积累,目前已完成多语言 README(中文、日语、韩语、法语、英语),社区参与度高。
介绍
这套 Skill 源自 45 本剧作专著与 23 套已上映剧本/舞台剧脚本,涵盖中美英日韩五大剧作体系。不同于泛化的写作提示词,它把每个编剧场景拆解为可操作的子技能——从「故事结构规划」到「对白去套话」,从「契诃夫戏剧法」到「小津安二郎电影剧本风格」,每条技能都包含原理、清单和真实案例。
SKILL.md 源文件以中文书写,因为原始素材大量来自中文原创或中译版本。AI 在运行时根据用户提问语言自动翻译输出——问英语得英语,问法语得法语,源文件本身不产生多语言维护负担。
技能体系分为六大领域:工作流与故事圣经(sw-workflow、sw-format-adaptation)、结构与前提(sw-story-structure、sw-premise-theme)、人物与冲突(sw-character-conflict)、对白与场景(sw-dialogue、sw-scene-craft)、改编与格式(sw-adaptation、sw-chinese-series-practice)、行业与商务(sw-industry-business)。此外还有两个大师级技能:契诃夫戏剧法(sw-chekhov-dramaturgy)提炼了《樱桃园》《海鸥》等经典四幕结构,小津安二郎剧本风格(sw-ozu-screenplay-style)拆解了《晚春》《东京物语》等六部经典电影的叙事语法。
特点
- 45 本专著 + 23 套脚本做背书:知识密度远超市面大多数写作提示词,非泛化生成
- 24 个子技能自由组合:按需调用而非一次性加载全部上下文,节省 token
- 运行时多语言输出:中文源文件 → 英/日/韩/法输出,无多语言维护负担
- 跨 Agent 平台兼容:Claude Code + Codex 双平台,agentskills.io 标准,npx skills add 一次搞定
- 支持美/日/中/韩剧作体系:非英语母语的编剧知识同样被系统性收录,对中文用户尤其友好
使用方法
安装步骤:
Claude Code:
/plugin marketplace add jtydhr88/screenwriting-skills
/plugin install screenwriting@screenwriting-skills
或手动克隆到本地:
git clone https://github.com/jtydhr88/screenwriting-skills.git
cp -r screenwriting-skills/plugins/screenwriting/skills/* ~/.claude/skills/
OpenAI Codex:
codex plugin marketplace add jtydhr88/screenwriting-skills
或手动:
git clone https://github.com/jtydhr88/screenwriting-skills.git
cp -r screenwriting-skills/plugins/screenwriting/skills/* ~/.agents/skills/
基本调用:
– /screenwriting:sw-story-structure — 规划故事节拍表
– /screenwriting:sw-dialogue — 改写对白,去除”说教感”
– /screenwriting:sw-chekhov-dramaturgy — 用契诃夫式四幕结构重塑剧本
– /screenwriting:sw-ozu-screenplay-style — 模仿小津安二郎的”省略美学”写剧本
最小示例:
/screenwriting:sw-dialogue
输入:人物 A:"我觉得我们应该冷静下来谈谈这个问题。"
输出:人物 A 沉默三秒,把咖啡杯推到桌子另一侧。
→ "……你先说。"(语气平,但肢体语言暴露了抗拒)
使用场景与人群
- 编剧/剧本写作者:快速获得结构参考、对白打磨工具和格式校验
- 影视项目策划:用 story-bible 技能管理多集剧集的设定一致性
- AI 应用开发者:将专业编剧知识封装进自己的 AI 产品
- 内容创作者:短视频、 Podcast 文案、小说的结构规划(借鉴剧本技法)
- 戏剧/影视专业学生:用 Agent 做”陪练”,获得基于经典案例的即时反馈
输入与输出案例
案例一:输入 → 输出(故事结构)
输入:帮我用节拍表规划一部 120 分钟的电影,主题是”中年危机的父亲与叛逆的女儿和解”。
输出:
– 开场景(0-5 分钟):父亲独自在家,女儿发来”我结婚了”短信,镜头语言建立两人疏离关系
– 催化事件(12 分钟):女儿突然回家,发现父亲住院一周没人告知
– 辩论阶段(12-30 分钟):父女争吵,双方各自陈述立场,揭示三年前的”断交事件”
– 中点(60 分钟):父亲翻出旧相册,两人童年回忆交叉剪辑,情感转折
– ……(Agent 给出完整 15 点节拍表,含时间戳和情绪走向建议)
案例二:输入 → 输出(对白改写)
输入:这段对白太”说教”了——「我认为我们应该理性看待这件事,毕竟我们都希望家庭和睦。」帮我改得更真实。
输出:
改后:父亲没有立刻接话。他把电视遥控器翻了个面,屏幕定格在某个旧新闻画面上。「……你妈上次走之前,」他顿了顿,「也是这么说的。」
(隐喻式回应而非直接陈述;以物件/动作为载体;情绪强度通过沉默和张力体现而非台词堆砌)
评论区
登录后可评论。