Tooluck logoTooluck
SKILL.md

sw-workflow

Agent skill fromjtydhr88/screenwriting-skills

Project orchestrator for the screenwriting skill set (剧本项目主线调度 / 状态存档 / story bible) — a meta-skill that adds no new craft knowledge but routes a screenplay or stage-play project through stages (premise → structure → character → scenes → draft → revision → submission) and a TV / streaming series project (电视剧 / 剧集 / pilot / 一季) through a separate series stage table (engine → character network & season arc → documents/bible → pilot structure → break story & outline → draft → submission), names which sw-* skill to invoke at each stage, defines each stage's deliverable and advisory exit check, and keeps all project state in a story-bible.md file so work can resume across sessions. Use when starting a new script project, resuming one ("continue my screenplay", "where were we"), when the user asks "what should I do next" on a script, when converting a vague idea into a full development pipeline, or when the other sw-* skills are firing individually and the overall process needs sequencing.

How to install sw-workflow

install sw-workflow
# install the screenwriting-skills pack with the skills CLI
npx skills add jtydhr88/screenwriting-skills

# or add only this skill to Claude Code: copy the folder

plugins/screenwriting/skills/sw-workflow/

# into

~/.claude/skills/sw-workflow/ (all projects)

.claude/skills/sw-workflow/ (one project)

plugins/screenwriting/skills/sw-workflow/SKILL.md

MITFull file
1# 剧本项目主线调度(Workflow & Story Bible)
2
3本 skill 不含新的编剧知识,只做两件事:**排顺序**(哪个阶段调用哪个 skill、交什么、什么算过关)和**存状态**(把每阶段结论写进 `story-bible.md`,下次会话接着做)。所有方法都在其他 sw-* skill 里,本 skill 只负责在正确的时刻把它们叫出来。
4
5设计依据来自一次对照实验:同一题目,按流程先填工作单再写,与不用流程直接写相比,篇幅、主角主动性、对手强度、潜台词全部不同;差别不在知识,在于"动笔前必须填的表、写完后必须过的清单"。本 skill 就是那张表和那份清单的调度器。
6
7story-bible 模板与各阶段工作单见 [reference.md](reference.md);跨语言输出时的术语锚定表见 [terms.md](terms.md)。
8
9---
10
11## 一、会话协议(每次开始与结束都执行)
12
13### 开始
14
151. 在当前目录(或用户指定的剧本目录)找 `story-bible.md`。
162. **找到**:只读"当前阶段""已定决策""决策日志"三节,用三句话向用户复述:项目是什么、做到哪一步、上次定了什么。然后直接进入当前阶段,不重新讨论已定决策,除非用户主动推翻。
173. **一次性交付不建 bible**:用户要的是一份当场交出去的文档(开发方案、提案、一页梗概、分集大纲),且明显不会有下一次会话来接——这时建 bible 是净成本,直接在同一会话里按阶段表跑完即可。bible 解决的是**跨会话丢上下文**,不是"流程要有表"。
184. **没找到且是持续项目**:判断入口路径(见第三节),按 reference.md 模板新建 `story-bible.md`,只填"项目信息"和"当前阶段",其余留空。不要一次问用户四个以上的问题;能从用户的话里推断的先填上,标"(待确认)"。
19
20### 进行中
21
22- 每完成一个阶段的交付物,立刻写进 story-bible 对应节,并把"当前阶段"推进一格。
23- 任何改变既定决策的动作(换前提、换结尾、删人物)都在"决策日志"加一行:日期、改了什么、为什么。
24- story-bible 保持在一次能读完的长度(约 25K token,中文 1.5 万字以内)。产物只写结论,不写推导过程;大纲、处理台本、剧本正文放独立文件,bible 里只记文件名和一句状态。
25
26### 结束
27
28- 会话结束前确认 story-bible 已更新到最新,最后一行写"下一步:"一句话。
29
30---
31
32## 二、阶段图
33
34| # | 阶段 | 调用的 skill | 交付物(写入 story-bible 的节) | 建议通过标准 |
35|---|---|---|---|---|
36| 0 | 启动 / 续写 | 本 skill | 项目信息、入口路径、当前阶段 | 知道要做什么类型、多长、给谁 |
37| 1 | 选材与前提 | `sw-premise-theme` | 闪念与"为什么在乎"、主旨一句、假设问题、**前提**(人物特质+导致+结局)、**主控思想**(价值+原因)、第三条轨道(渴望 vs 错误信念)、戏核、一句话故事、logline | 前提只有一个;能向陌生人一句话说清;戏核抽掉戏不成立;主题词定了 |
38…

Excerpt shown under the repository's MIT license.

More skills in screenwriting-skills

Keep exploring

Similar skill repositories

thedotmack /

claude-mem
116k

Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More

CCCXGHGM+135 skills

Newsletter

Join the Community

Subscribe to our newsletter for the latest news and updates