SkillAgentSearch skills...

sw-writers-room

How episodic television actually gets made by a group (编剧室与制作现实) — merged from Goldberg & Rabkin (pitch as audition, leave-behind, cracking the story, beat sheet, notes discipline, production rewrites), Pamela Douglas (John Wells's room, staff-from-hell mistakes, the seven-rung ladder, step deal, th…

Install / Use

npx skills add jtydhr88/screenwriting-skills --skill sw-writers-room

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

86/100

Supported Platforms

Universal

Tags

Our assessment of sw-writers-room

sw-writers-room scores 86/100 on our quality scale, 2410th of 4,700 Development & Engineering skills we index.

Its SKILL.md is 22 KB long, well organised into 15 sections and no code examples: a thorough specification that gives an agent plenty to work with.

With 1,376 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
30/30
Structure
13/20
Description
15/15
Adoption
13/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so sw-writers-room is actively maintained.
  • Our last check on 2026-11-03 found the source still online.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-03. Automated pattern scan on 2026-10-03. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

sw-writers-room compared with similar skills

All 4 of these similar skills score higher than sw-writers-room; compare them before choosing.

SkillScoreStarsUpdatedFormat
sw-writers-room (this skill)by jtydhr88861.4k55d agoSKILL.md
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
ai-job-searchby ai-job-search-dev10072.1ktodayCLAUDE.md
claude-howtoby luongnv8910047.3k2d agoCLAUDE.md
lobehubby lobehub10085.6ktodayMCP Server

Frequently asked questions

How do I install sw-writers-room?
Run npx skills add jtydhr88/screenwriting-skills --skill sw-writers-room. The install tabs above show the steps for each supported agent.
Which AI agents does sw-writers-room work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is sw-writers-room safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is sw-writers-room still maintained?
The repository was last updated about 2 months ago, so sw-writers-room is actively maintained.

name: sw-writers-room description: How episodic television actually gets made by a group (编剧室与制作现实) — merged from Goldberg & Rabkin (pitch as audition, leave-behind, cracking the story, beat sheet, notes discipline, production rewrites), Pamela Douglas (John Wells's room, staff-from-hell mistakes, the seven-rung ladder, step deal, the 14-day draft), Neil Landau's showrunner interviews (Lindelof, Mazzara, Katims, Bays), Evan Smith on sitcom staffing and roundtables, Richard Blum (dated), Kam Miller, and first-hand accounts by David Chase, Jesse Armstrong, Lucy Prebble, Aaron Sorkin, Julian Fellowes and Phoebe Waller-Bridge. Use when joining or running a writers' room, breaking an episode with a group, writing a leave-behind, beat sheet or outline on deadline, pitching episode ideas to an existing series, writing a spec episode, taking or giving notes, rewriting because of money, actors or locations, choosing between a staffed room and a single-author process, or asking 什么是 showrunner/编剧室怎么运作/怎么接 note.

编剧室与制作现实(Writers' Room & Production Reality)

输出语言=提问语言;术语一律锚回原词,见 sw-workflow/terms.md,不自创译名。

电视剧不是一个人写完交出去的。它是一个房间里的一群人,在固定日程和固定预算下每周生产一集,而这个生产过程会反过来改写你的剧本。本 skill 讲:房间怎么运作、文档按什么体量什么顺序交、故事怎么在集体里被"破开"、note 怎么接、职级怎么爬、钱/演员/天气/场地否决你时怎么改而不毁掉这一集。

日程表、文档实物与访谈原话见同目录 reference.md。

三个前提(多书共识):① "电视的整个阶梯建筑在编剧的各种衔头上"(Douglas 中译本第 5 章 p0199),与电影业"创作权力在导演、出资人可以买头衔"根本不同(Blum 第 19 章 p0246)——学剧集编剧就是学怎么当 writer-producer。② "An episode is a product made every week in a specified number of days for a certain price and delivered at a guaranteed running time on an inflexible deadline."(Goldberg & Rabkin 第 1 章 p0019)③ 房间里的表现比你的点子重要,甚至比你最终那本剧本重要——"crafting stories is much harder than actually writing scripts"(Goldberg p0086)。

不含:幕结构与页码锚点、季形(→sw-series-structure);剧集设计、引擎、bible、pitch document 字段(→sw-series-engine-bible);喜剧笑点力学与喜剧房 punch-up(→sw-sitcom-comedy)。美国合同、期权、署名仲裁、经纪制度的通论已在 sw-industry-business 第五、六节,本 skill 只写剧集特有的 step deal 与 staff 薪酬。国产剧制片链、备案审查、一度二度三度创作、分集大纲体系见 sw-chinese-series-practice。 通用对白/场景/人物方法见 sw-dialogue、sw-scene-craft、sw-character-conflict。

reference.md 放实物、日程与长案例:break story 七套方法总表(一)、Prebble 四条房间规则(二)、leave-behind 实物规格(三)、outline 格式与硬批注(四)、14 天法(五)、彩页与 cut-outs(六)、spec 选剧规则(七)、片头逐镜与 stasis 提问(八)、pitch 全套现场纪律(九)、note 实操四件(十)、职级表与 step deal(十一)、七宗错全文(十二)、场地与预算的账(十三)、瓶子集(十四)、演员(十五)、alts 与素材回收(十六)、救不回来的一集(十七)、五套流程对照表(十八)、Wells 的 ER 编剧室实录与 Souders/West 的房间(十九)、职级与钱的四书对照表(二十)、多机位一周制作表与 freelance 时间表(二十一)、六周专业日程与 14 天法(二十二)、beat sheet 与 leave-behind 的六份实物(二十三)、Fellowes 的 419 条脚注法则(二十四)、Succession 的被剪戏迁移链(二十五)。

按任务读哪几节(不要通读)

本节 38 KB,reference 75 KB,逐节读完通常是浪费。

| 任务 | 读 | 跳过 | |---|---|---| | 接 note / 回应审读意见 | 五(接 note 与给 note),尤其 5.1 的排序方框 | 二、三、六 | | 改稿 | 三(文档链与体量)、七(制作现实)、十(诊断清单)的"改稿与制作"组 | 四、六 | | 在房间里破故事 | 二 | 四、六 | | 写 spec / 向既有剧 pitch 单集 | 四 | 二、七 | | 了解职级与钱 | 六(全部标了年份,只看相对关系) | 其余 | | 单人写作、没有编剧室 | 八(流程选型) | 二、六 |

reference.md 是日程表、文档实物与访谈原话,只在正文指向时打开。



来源与各书关系

  • Goldberg & Rabkin《Successful Television Writing》(Wiley, 2003)给骨架:两位作者从 Spenser 的 spec 做到 Diagnosis Murder 与 Martial Law 的 showrunner;全书是"为一部既有剧集写、卖、改一集"的工序手册,附录有真实 leave-behind 与 beat sheet 实物。时效:一小时剧"一律四幕"与 $27,000 是 2003 年数据。
  • Douglas《Writing the TV Drama Series》(第 3 版 2011;另有较早版中译本)给房间的物理学与阶梯:第 5 章是唯一把编剧室当作有办公室位置、有文化、有政治的场所来写的;第 4 章给 outline 格式与 14 天法;第 6–7 章给 spec 规则与十四年追踪访谈。
  • Landau《The TV Showrunner's Roadmap》1e(2014)/ 2e(2022)给同代 showrunner 的一手工艺决定,也是本 skill 分歧最集中的来源(Lindelof vs Mazzara,Hillian vs Levinson)。
  • Smith《Writing Television Sitcoms》第 14–19 章给 pitch 会与 roundtable 的现场细节;Blum 第 18–19 章给 1999–2001 年市场结构与四位 showrunner 的工作习惯(数字已过时,结构性判断仍有效)。
  • 剧本集与评注给"真的发生了什么":Chase 的 Sopranos 前言(35 拍、剪刀胶带)、Armstrong 与 Prebble 的 Succession 前言/脚注(mega-chart、maybe 文化、alts、freebie take、写长)、Sorkin 的 West Wing 序(预算逼出瓶子集)、Fellowes 的 Downton 脚注(剪辑合议、演员演得好就删对白)、Waller-Bridge 的 Fleabag 评注(单一作者的替代编剧室)。
  • Miller《Your Hero Succeeds》第 9–10 章给稿次纪律与两轮读者:稿名=稿次、warm read/cold read、三条筛 note 法则。

一、编剧室是什么:showrunner 的职责与权力

定义(Armstrong,Succession S4 前言):showrunner "essentially a writer. But a writer empowered to protect the scripts through the rooms where they are conceived and written and rewritten, performed, captured and edited."——四个动词就是职权范围。

  • 做决定并传达(Goldberg 第 15 章 p0121–123):"there's really only one skill an executive producer needs to succeed: he has to be able to make a decision and communicate it."反例 Ferd:今天"连环杀手在杀修女",明天"修女在杀连环杀手",擦白板重来;他不决定,剧本/选角/勘景全停,每天烧钱,没撑过一年。
  • 当剧的唯一声音(Mazzara,Landau 1e Tip 13):"I have several scripts this year that I've written every word of and have not put my name on them"——出来的集子若不是这个声音,制片演员剧组都会觉得不对。
  • 让导演在 prep 第一天拿到可 prep 的剧本(Hart Hanson,Bones,Landau 1e Tip 17):"I think that's the first responsibility"——不能让导演花两三天对着可能还会改的 outline 工作。
  • 握最终剪辑权:Robert King(Landau 1e)"TV showrunner has final cut… twenty-two to twenty-three little movies every year."Chase 的分权(Sopranos 前言 p0012):剪辑师初剪 → 导演剪(换镜头但一般不重排场序、不删场)→ showrunner 出多版到 final,可重排可删场。
  • 不把关键东西交给委员会(Bays,HIMYM,Landau 1e Tip 21):房间会大改,"but that mostly just applies to the comedy. The dramatic moments I try to not mess with or punch up in the room. Drama needs to feel personal, and can't be written by committee."
  • 上去之后主要是管理:Goldberg p0123"80 percent of the job is management";Souders 做 Smallville showrunner 时(Douglas 英文版第 7 章,2011)"写作现在只占我工作的 15%",其余是预算、管理、大量电话——"I miss it. That's what I got into this for."
  • 定房间的气氛(Prebble,Succession S3 前言):Armstrong 把主持编剧室比作办派对——"you're responsible for the guests and the atmosphere and ensuring people want to come."

"所有 EP 中只有一个是 showrunner。" 片尾的 executive producer 是三类人(Douglas 中译本 p0206–207):管实拍的/head writer(管内容,含导演、选角、剪辑)/给明星的荣誉头衔。判别法是看谁做关键决定:ER 的 pilot 由 Michael Crichton 写、他整季挂 EP credit 但不在剧组工作,"只有一人——约翰·威尔斯——做出关键性的决策";反向案例是某动作剧的四个 EP"写剧本没问题,管剧完全不会",真正在跑的是挂名 Creative Consultant 的半退休大佬。→ 进组第一件事是搞清楚谁真的在跑这部剧,并向那个人负责。

你在房间里的身份:Goldberg 的 staff 哲学(p0124)"It's your show. Tell us what you want, and we will give it to you.";Wendy West(Dexter co-EP,2011)"防御心来自想保护自己的声音,而你在一部剧上不是去保护你的声音的……When you're in this room it's not about your voice. Make your showrunner look like a star.";配套"变色龙"规则"you have to adapt to the style of the show you're writing"(but "That doesn't mean losing your voice")。


二、break story:房间里怎么把一集故事破开

Goldberg 称之为 story meeting / "cracking the story":先泛谈故事可走的路,达成共识后转到大白板,逐 beat、逐场、逐幕——"this lively and arduous give-and-take that is the soul of television writing"(第 11 章 p0085)。七套真实方法,先选一套,别混用;完整流程与日程见 reference.md 第一、二节。

七套方法的对照总表(出处、一句话做法、人数/周数/beat 数的量化锚点)见 reference.md 第一节;Prebble 的四条房间规则(pitch 起手式、两条排序规则、maybe 文化、"房间的产出是这部剧不是什么")见第二节。ER 编剧室的物理配置(十把椅子、12 集白板、Big/Serious/Humorous/Other 四标题)、六月六周铺季与一集八周的时间表、一场真实 notes 会的逐步实录,以及 Smallville 的匿名读稿与 Dexter 的二月 camp → reference.md 第十九节。

worst case 的严格定义(Douglas 第 4 章,最常被做错的一条):最坏的事是"与主角目标对立的事/对手的胜利",不是泛泛的坏事——医生怕妻子不爱他、同时有病人要手术、外面下雨,worst case 是妻子拒绝他,不是病人死或洪水。配套四条裁判规则(学生 Sonny 的清单):每个 beat 是一个动作(人物"意识到"什么不是一场戏);对手要和主角一样强一样有动机;瞄准一道近乎平衡的道德方程;worst case 锚在四分之三处。另加:读卡片时像在看屏幕——你无聊观众也无聊。

反方:拒绝 outline、拒绝 A/B/C(Mazzara,The Walking Dead,Landau 1e Tip 13)。"I don't use outlines… I can't shoot an outline… they are used to engage TV and studio executives… None of their notes are applicable to script."替代:给平台两三页 story document(段落体,说明本集要达成什么、主要 set piece 是什么);他自己只用 beat sheet,每个 beat 两三个词("Rick kills Shane.")。也不用 A/B/C——"That doesn't always equal a theme. It just pushes the ball further on each one.",改问 "What is this episode about?";代价他自认是次要人物可能永远只是次要人物。同侧:Gilligan(Breaking Bad)六人全天在房、不用 A/B/C、逐集 "brick by brick",mantra 是 "Where is Walt's head at? What does he want right now? What is he afraid of?" → 怎么选:要向平台报批/line producer 要据此勘景做预算/你是 freelancer 或新人 → 必须写 outline;你是 showrunner 且个人能扛结构 → 可以只用 story document+十词 beat sheet,但这是权力的副产品,不是方法上的优越。多线群像、线要交织 → A/B/C+彩色卡片;单一主角的压力剧 → "这集关于什么"一个问题。

房间通用操作规则(跨书共识)

  • 先快速跑到各幕出口和结尾,再回头改好(J.J. Abrams,引于 Douglas 第 5 章):"get to the act breaks and the end quickly, so you can reverse and make it better."
  • 一次只解决一个问题(Matt Williams,Smith p0280):别管第二幕的 blow,等到了那儿再换挡;年轻编剧的毛病是 "chase everything in the script at once"。
  • 你的工作不是指出问题,是给出更好的方案(Gurvitz,Smith p0279):"your job is to pitch a better joke or story fix."反方保留:Kalish 引 Norman Lear——"Don't be afraid to put your finger on something that's wrong, even if you don't know how to fix it."→ 折中:明说"我没有解法,但这里我不信",并承担接下来十分钟的讨论。
  • 同一提议被否三次就停(Sandy Frank,Smith p0281);更糟的是一路往下 pitch(EP→co-EP→supervising producer→story editor),最后只有小编剧附和你。
  • 把 showrunner 放在"求助者"位置(Craig Thomas,Landau 1e Tip 21):"I'm trying to figure out the story and these guys are helping me do it"——比"What do we as a hive mind think this story should be?"好用。房间要有不同类型的人(Lloyd):"encourage quieter, more thoughtful writers to come forward, and sometimes need to butterfly net the more aggressive ones."
  • 最好的集子来自真事(Bays & Thomas):"The best episodes always come from real stories. Like, 100 percent of the time, without fail."制度化禁令可以救一个跑偏的房间(Johannessen 接任 Dexter S5):他立了一条 no metaphors rule——"Because everyone came up with metaphors and nobody came up with an actual story."
  • 每个改动都要算价(Miller 第 9 章引房间口径):"What does this change buy us? … If it costs us more than it buys us, we think of another direction."

三、文档链与体量:从一页纸到彩页

顺序固定,体量有数,每一步都有人要签字。 实物样本见 reference.md 第三节。

  • 3.1 leave-behind:一页三段的原文规格、"对平台版"与"对剧方版"两份、阴谋线的 "What we will discover is that…" 写法 → reference.md 第三节;两份真实 leave-behind 的抬头、体量与差别见第二十三节。
  • 3.2 beat sheet/outline:treatment/beat sheet/outline 术语辨析、6–20 页与 WGA 的 7 个工作日、每幕一页、四个用途、Douglas 四条硬批注、temp dialogue 两难 → reference.md 第四节;四份真实 beat sheet 的格式对照、场数分布与"first draft 可以留白到什么程度"见第二十三节。
  • 3.3 初稿:任务稿不打招呼大改的教训、14 天法的逐日安排、开工前的半小时准备、稿名=稿次的三条硬规则 → reference.md 第五节;单集六周专业日程(梗概 1 周→改几天→一稿 2 周→notes 1–2 天→二稿 1 周→润色 1–2 周)与 14 天法的逐日七步见第二十二节;sitcom 的 freelance 各阶段天数见第二十一节。
  • 3.4 二稿、polish、彩页:revising≠rewriting、polish 与 cultural wash 的界定、pink→blue→green 的彩页顺序、cut-outs 文档、写长 vs 写短 → reference.md 第六节。

四、给一部既有的剧写:spec、研究、pitch 单集

本节三部分的全部规则、实录与原话已移入 reference.md:

  • 4.1 spec 的选剧规则:选剧五条、两个"几乎"、Martial Law 招人实录、Douglas 的 "DON'T SPEC THE SERIES YOU PLAN TO PITCH." 与相反的"童话" → reference.md 第七节。
  • 4.2 研究一部剧:片头逐镜拆解的三类与判据、stasis 提问法、catch the voices、带一个只有你能带的角度 → reference.md 第八节。
  • 4.3 pitch 单集:带几个/每个多长(三书合并)、讲什么怎么讲、六位制片人的现场纪律、pitch 什么(选题层面)、三种结局、stenographer 规则、"你不知道的制作现实"清单 → reference.md 第九节。

五、接 note 与给 note

5.1 接 note 的七条(Goldberg 第 13 章 p0103–106):① 最重要的是听。不要争、不要解释、不要辩护——"we think it's a cliché and we want you to change it. Say 'got it' and move on."② 但只点头不够:若某条 note 会制造比它解决的更多的问题,问这条 note 想修的是什么问题("给 note 的人都在试图帮忙,只是常给的是解法而不是问题")。③ 区分两类 note:overall(tone、style、characterization、structure——最严重)与 line/page;overall 又分"给路线图的"与**"the killer"(只说不喜欢不给解法),遇到后者别只记下就走**,必须当场抛一个建议引发讨论——"it's in no one's best interest to let you leave the room without an idea for a fix"。④ line notes 要全做,别挑着做(一稿里让他烦的东西再见到只会更烦)。⑤ 把 notes 写下来——自称记性好的编剧,rewrite 里几乎从不包含所给的 notes。⑥ 拿到你痛恨的 note?"Do the notes. And do them well." 理由只有一个:"Whether you do it or not, the note is going to get done." ⑦ 把 ego 拿出会议室——seaQuest 的第一稿被 Hasburgh "Hated it. Hated it. Hated it.",作者与搭档发泄一晚,次日开场就说"We know you hate the script. So forget it. Don't bother giving us notes on this draft",把剧本扔进垃圾桶,"let's go back to the outline and figure out how to make this a script you'll love"——变成高效工作会。

先说清这一节真正有用的是什么。 "敢于拒绝一条错的 note"不需要 skill 教——拿到"删掉这个人物"这种意见时,不照办并给替代方案是常识。本节的价值全在措辞与机制:把"这条线散"诊断成"编排同型"(于是知道该改出价单位而不是减人)、把"拍不了"翻译成"这一稿靠换地点推进"、以及下面那条排序。照着说理,而不是照着壮胆。

⑥ 与 ②/5.3/诊断 26 的排序(本条是本 pack 补的,Goldberg 没有给)。 字面上

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars1.4k
CategoryDevelopment
Updated1mo ago
Forks155

Languages

Python

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions