SkillAgentSearch skills...

sw-series-structure

Episode and season structure for TV series (剧集单集与季的结构) — teasers and cold opens, broadcast four/five/six-act grids with page anchors, three tests for finding the invisible acts in streaming scripts, act-out and cliffhanger taxonomies, Oberg's four information tools, A/B/C/runner weaving and scene-co…

Install / Use

npx skills add jtydhr88/screenwriting-skills --skill sw-series-structure

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-series-structure

sw-series-structure scores 86/100 on our quality scale, 2409th of 4,698 Development & Engineering skills we index.

Its SKILL.md is 23 KB long, well organised into 31 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-series-structure 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-series-structure compared with similar skills

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

SkillScoreStarsUpdatedFormat
sw-series-structure (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-series-structure?
Run npx skills add jtydhr88/screenwriting-skills --skill sw-series-structure. The install tabs above show the steps for each supported agent.
Which AI agents does sw-series-structure 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-series-structure 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-series-structure still maintained?
The repository was last updated about 2 months ago, so sw-series-structure is actively maintained.

name: sw-series-structure description: Episode and season structure for TV series (剧集单集与季的结构) — teasers and cold opens, broadcast four/five/six-act grids with page anchors, three tests for finding the invisible acts in streaming scripts, act-out and cliffhanger taxonomies, Oberg's four information tools, A/B/C/runner weaving and scene-count ratios, the Calvisi pilot beat sheet, five-part scene structure, and season shape (tentpoles, bottle and container episodes, two-parters, finales). Merged from Calvisi, Douglas, Oberg, Landau, Goldberg & Rabkin, Miller, Rabkin and Blum, plus act lengths measured from published West Wing, Succession, Sopranos, Downton and Fleabag scripts. Use when breaking an episode into acts, deciding how many acts a script needs, placing act outs and cliffhangers, designing a teaser, weaving A/B/C stories and runners, beating out a one-hour pilot, auditing an episode that has no shape, reverse-engineering a show's structure, or planning a season's episode order (分幕、出幕、悬念结局、季弧、瓶子集).

剧集结构(Series Structure:单集与季)

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

分工:Calvisi 给 pilot 的逐节拍页码区间,Douglas 给四幕格子与场数,Oberg 给"格式 vs 结构"的地基与信息管理四工具,Landau 给幕数抽样与 cliffhanger 类型学,Goldberg & Rabkin 给经典广播四幕的功能表,Miller 给 landmark 与场结构五件套,Rabkin 给流媒体时代的提速规则,Blum 给各节目类型的幕数页数表,五部剧本集(West Wing / Succession / Sopranos / Downton / Fleabag)给可验证的实测数字。

表格、完整节拍表与逐集数据见同目录 reference.md。

本 pack 用的英文术语、严敏中译本的官方译名与一句话定义的四列对照表见 reference.md 第十二节(含 log line="计程绳"、staff writer="试用编剧"两处怪译,以及"晚进早出"与 enter late, leave early 同名反义的警告)。

不在本 skill 里:series engine / franchise / bible / pilot 类型与卖法 → sw-series-engine-bible;半小时喜剧的笑点与格式 → sw-sitcom-comedy;编剧室流程与文档链 → sw-writers-room;国产剧集数体量与分集体系 → sw-chinese-series-practice;逐集结构表全文 → sw-series-case-studies / succession-series-writing。媒介无关的工艺不重写:场景价值转折见 sw-scene-craft,对白见 sw-dialogue,三幕范式与情节点见 sw-story-structure。

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

本节 38 KB,逐节读完通常是浪费。按手上的任务只读对应几节:

| 任务 | 读 | 跳过 | |---|---|---| | 破一集的结构 / 排幕 | 二(容器与幕)、三(出幕与信息管理)、四(A/B/C 编织) | 五、七、八 | | 写或改 pilot | 五(pilot 节拍表)、二 | 七(季形)、六 | | 诊断一份已有的大纲或剧本 | 九(诊断清单),再按失败项回查对应章节 | 其余全部 | | 排一整季 | 七(季形)、四 | 五、六 | | 写半小时喜剧 | 仅三、六的媒介无关部分 → 转 sw-sitcom-comedy | 二、五的页码(一小时专用) | | 写国产 45 分钟剧 | 三、四、六 → 时段与场面数转 sw-chinese-series-practice | 二、五的页码 |

reference.md 是查表用的,只在 SKILL.md 明确指向某一节时打开。



一、剧集结构与电影结构的根本差异

  • 更紧的形式,所以更难不是更容易。 Douglas 中译第 3 章(p0088):"电视剧本要求把所有同样的要素浓缩在更紧凑的形式中。"电影一场可 5–7 页,电视一场目标 2 页——"如果你一开始用 4 页纸写一次会面戏,那等于挂红旗"。
  • 剧本模拟剪辑后的成片,不是拍摄素材,要让读者得到"观众看剧"的体验(Calvisi)。
  • 编剧亲手给幕贴标签,没地方可藏(Calvisi 列为电视剧本的第一格式差异):"There is no place to hide."不分页的 pilot 看起来像在 cheat,与调小页边距同属立刻暴露业余的手法。
  • 场景编号不是戏剧意义的场。 Douglas:一个建筑物外景"就不是完全戏剧意义上的一场戏";一个 dramatic beat 可含多个 slug line,它只与故事的发展同步,与景不同步。Oberg 的计数规则:主角或目标变 → 新 dramatic scene;地点或时间变 → 新 logistical scene;结构文档按 dramatic scene 计数。
  • 成片长度与剧本长度是两个数字(Calvisi):广播台正片去掉广告只有 45–48 分钟,但 pilot 剧本必须至少 50 页——宁长勿短,"but try not to exceed 60 pages"。
  • 剧集的"幕"不是戏剧原理,是广告位。 Oberg 第 1 章把任何规定固定份数与页数的切分法叫 story format(logistical,物流式),源头是戏剧换蜡烛、电影换胶片卷、电视插广告,"But all this is gone.";"香肠串"比喻:物流法只决定"几根香肠、多长"。本 skill 最重要的判断力:幕数是交付格式,三幕(before / during / after 一个 main dramatic action 或 evolution)是设计工具。
  • 但结构同时是制作排程。 Miller 第 9 章:制作部门拿到剧本第一件事是统计 days in and out;只写 DAY 或 NIGHT——写 dawn 制作就会精确安排那天日出时段开拍。
  • 结构是继承的。 剧集沿用 pilot 的幕结构与页码区间(Breaking Bad pilot 与同剧 #308 的幕页对照见 reference.md 第一节)——写 pilot 等于给全剧定结构模子。

二、单集容器:teaser、幕数与页码锚点

2.1 广播四幕的功能链(Goldberg & Rabkin,2003)

Act One 介绍角色、冲突、赌注 → Act Two 幕尾必须把故事推向"startlingly new and unexpected direction"(Law & Order:警察逮捕了一个意想不到的人)→ Act Three 幕尾主角以为控住了却发现错了,"They are all going to die. There is no hope." → Act Four 想出办法、达成目标。

时效 flag(2003):该书称"一小时剧一律四幕",已过时——2006 年起广播网普遍五幕、ABC 新剧一律六幕(Douglas 中译 p0091),流媒体取消幕标记。但四幕功能链至今有效:Miller 与 Landau(2021)都仍要求先按四幕 break 再切。

页码锚点(Douglas 中译 p0090–0091,含 teaser 的四幕初稿)的四个页数与"每 13 至 15 分钟一次广告"的成因见 reference.md 第二节。

⚠️ 这些页码只在 48–63 页的美式一小时集内有效,不能按比例换算到国产 45 分钟集。 两套切法的依据不同:美式按页数与广告位切幕,国产按时段与片断切(正片约 41.5 分钟,开场 3 分钟+每 15 分钟一个小扣子+集尾大关子)。写国产剧时本节只取媒介无关的部分(出幕类型学、一幕尾是"主角被推进没有退路"、Act Two break 改变故事性质、场结构五件套、赌注检验、信息管理四工具),时段与场面数改用 sw-chinese-series-practice。 半小时剧同样不适用(30 分钟本约 30 页,幕数与场数都是另一套):幕长、页码与场数见 sw-sitcom-comedy 第四节,不要把本节的一小时数字缩放过去。本节下面的诊断 4、5 两条只对美式一小时集有效。

2.2 场数:每幕 5–7 场,一集约 28 场

Douglas 的算术、四幕 28 场/五六幕 20 场的总量、Oberg 的 A/B/C 场数配比与 Chase 的"每集约 35 拍"见 reference.md 第二节。

2.3 四幕 → 五幕 / 六幕的改法

Douglas、Peter Blake(House)、Miller 三套改法,以及"Act Six 实际是下一集的 teaser"的六幕尾部设计见 reference.md 第二节。

2.4 Teaser / cold open

  • 长度:Douglas、Landau、Oberg 三家的 teaser 长度数字见 reference.md 第三节。
  • 十种类型(Douglas 七范式+Landau 三型)的名目与实例见 reference.md 第三节。
  • 给新手的硬规则(Douglas 中译 p0098):"坚持以故事而非信息来开场……许多学生……误以为用重大的主题思想或抽象的哲理来开场会给人留下深刻印象。他们实际上是看到戏剧弧线推进的挑战而畏缩。最佳的引子倾向于最佳的戏剧化。"
  • teaser flashback 的禁忌(Oberg):可以从 dramatic action 的中段甚至末段起叙(The Walking Dead、Breaking Bad),但绝不能在 teaser 里回答 dramatic question;取材自结尾就选 climax 之前或之中(Run All Night),不要之后(John Wick)。
  • teaser 不是必需品:Landau 2e 与 Oberg 的论据、无 teaser 与"短第一幕充当 teaser"的剧目清单见 reference.md 第三节。
  • 国产 45 分钟集:teaser 与"开场 3 分钟钩子"(sw-chinese-series-practice 5.1)占同一位置,二者择一,默认留钩子。
  • cold open ≠ teaser(Miller):Brooklyn Nine-Nine pilot 的 cold open 不影响主线、只启动本集主题,所以该集 point of attack 落在第一幕。

2.5 隐形幕:三重判据

付费有线/流媒体剧本常不标幕也不分页(Calvisi 点名 True Detective、House of Cards、Mad Men 都不标幕,但 Mad Men 在常规幕断处放 FADE OUT),然而"a pilot script is almost always going to be structured in the conventional 4-6 act template"。从 Succession 剧本逐幕实测出来的三重判据:

三重判据:① 剧情日/时间块标记——换日就是换幕;② 地点与交通工具的切换;③ 核心问题转向的那一刻。判定标准:每幕末尾必须有一次信息或权力的转移,不必有悬念钩。逐条的 Succession 实测(S3E9、S4E01、S4E05、S4E08、S4E10)见 reference.md 第四节。

配套规律(Succession S4 十集):8/10 集把全集压进一个带固定程序的容器,程序节点替代 act break——即流媒体编剧仍然在写幕,只是把幕伪装成日程。逐集容器与场景数见 reference.md 第四节。

2.6 要不要在页面上写 ACT——必须并列保留的分歧

  • 五家立场(Landau 2e 的"story over format"、要看到标注的 showrunner 的反面、Miller 的市场判断、Mazzara 的 TWD 改幕、Alex Pina 的 milestone moments)见 reference.md 第二节。
  • 判据:为广播网/基础有线/AVOD 写 → 标幕(AVOD 与传统广播网一样不允许跳广告);为 premium/SVOD 写 → 按四幕 break、交付前删标注或改用剧情日标记;拿不定就照 Miller 的判据走,看内容能上哪个台。

2.7 页数与集长

Calvisi / Landau / Miller / Blum 的 pilot 与单集页数区间、Oberg 的各平台集长、Landau 2e 的趋势判断,以及各书年份的时效 flag 见 reference.md 第二节。


三、act out 与 cliffhanger 类型学,信息管理四工具

3.1 定义、反面教材与判准

  • Calvisi:每一幕(理想每一场)都要让人想知道接下来发生什么;幕尾常被称为 "Act-Out"。
  • Landau 2e 第 12 章:"A cliffhanger is a plot device that leaves one or more characters facing either a dangerous situation or a shocking revelation."
  • Oberg:cliffhanger"simply an unresolved conflict"——位置不止集末季末,还包括"离开一条 strand 之前"。
  • 反面教材 schmuck bait(Landau 2e):心电图拉平、护士喊 "Code blue!"(插广告)→"I'm getting a pulse"。
  • 今天的规则(Landau 2e 最核心的一条):"forcing a cliffhanger at the end of each act break is deadly… Instead, act breaks can land on a turning point that emerges from characters, not merely from plot."
  • 判准(1e Tip 19 与 2e 第 12 章两处重复):cliffhanger 必须 "grow out of character jeopardy, risk, or fear";坏 cliffhanger 只是为震惊值而来的情节点;"even a 'surprise' cliffhanger needs to be (subtly) set up so that the audience feels they should have seen it coming—but didn't."
  • 位置与时限:一小时剧把高潮型 cliffhanger 留到集末,多机 sitcom 通常在集中点(结尾要按 reset 键回到常态);可以延后揭示全部真相,但务必在本季结束前揭示(原话见 reference.md 第五节)。

3.2 十种 cliffhanger(Landau)

2e 七型(character in peril|ticking bomb|love is in the balance|surprise twist / aha moment|death of a character|discovery of a secret|life events)与 1e 另列三型(lack of closure|mini-cliffhangers|comedy cliffhangers)的逐条定义与实例,以及两个最可迁移的做法("用一个单词完成反转"、"不在笑点上出幕")见 reference.md 第五节。

3.3 act out 的八种形式与三条通用律

West Wing 六集实测的八型:悬念提问/反转台词/情感揭示/无对白动作/道具定格/重复台词语义反转/被剪断的 setup/伏笔兑现的手势。配套规则:每幕出幕交给不同的线;至少一幕用无对白动作或道具出幕,不要四幕全用台词——无台词的出幕必须先教语法。八型实例、Two Cathedrals 的教法与 Downton 的四型见 reference.md 第五节。

出幕可以完全是信息事件。 Goldberg & Rabkin 附录两集(Martial Law 与 seaQuest 2032 "Depths of Deceit")共有三条通用律:**① 一幕结尾不是最大危机,而是"主角被推进没有退路的处境";② Act Two break 一定改变故事的性质而不只是提高危险;③ Act Three 结尾必须让主角的胜利变成新的失败。**两集的逐幕对照见 reference.md 第五节。

3.4 悬念的成分与赌注检验

  • Douglas 的节奏公式(中译 p0139,英文版 Anticipation — Expectation — Surprise):预感 → 期望 → 惊诉,"然后开始一个新的悬念段落";NYPD Blue "Hearts and Souls" 六拍冷开场的逐拍示范见 reference.md 第六节。
  • Landau 2e:Suspense = Anticipation + Surprise,最好是 unexpected, inevitable but not predictable。
  • 赌注检验法(最实用的一条):问自己"面对危机什么都不做"对这个人物是否是可行选项——"If your character is not compelled to solve a problem by the potential of losing something of value, then your stakes are insufficient."
  • 极化模型:在每一集、每一场、每一幕找出正负(+/−)电荷;与旧做法的区别是act break 的方向可正可负——"some acts will end on a win"。

3.5 信息管理四工具(Oberg 第 1–2 章)

三维模型:人物是点;加 main dramatic action(conscious want)→ 线;加 main dramatic evolution(unconscious need)→ 面;加 managing information → 立体。Managing conflict 回答"Who wants or needs what and why?",managing information 回答"Who knows what and when?"

四工具(dramatic irony / surprise / mystery / suspense)的定义与用法表见 reference.md 第六节。

四条红线(① 不要让主角长期比观众知道得更多;② 做 cliffhanger 优先用"信息炸弹";③ closed mystery vs open mystery;④ "you can have some mystery over the nature of the antagonist, but not over the reality of the danger it represents.")的逐条展开见 reference.md 第六节。

Landau 2e 的缝合句:"it's not only Who Does What When, but also Who Knows What When."

3.6 提速:act out 不等于每七八分钟一次假反转

Rabkin 的 24 与 Scandal 对照、"把第四幕末最酷的事挪到 teaser 末尾"的原话、L+3 收视逻辑与"流媒体可以省掉三样"见 reference.md 第五节。


四、A/B/C/runner 的编织与配比

4.1 定义与排序

四家的定义与排序(Douglas 的"三个独立的故事"与 runner/Calvisi 的"字母按戏份多少排"与 story engine 三要素/Landau 的 A=franchise、B=私人故事、runners=C/D/Oberg 的"每集至少 A+B,最多 4–5 条、只有 A、B 需要设计成三幕")见 reference.md 第七节。

4.2 编织的硬规则

  1. Franchise(A 线)贯穿每一幕;B 线与 runner 按需插入,每幕一般 4–5 个 beat,理想情况下收在 A 线、落在主角的困境上(Landau)。
  2. 极少在 C 线收幕——"If the story is worthy of an act break, then it's not your C story – it's probably more your A or B story."(Landau 1e/2e 原话一致;Oberg 同条。)
  3. 但幕末悬念不一定在 A 线(Douglas 中译 p0095:"它可能是 B 故事的转折点")。West Wing pilot 实测:teaser 与第三幕的出幕都由 B 线 Sam–Laurie 承担。
  4. 不必棋盘式交替,跟随"兴趣线"(line of interest)。 Douglas 用 NYPD Blue "Simone Says" 第 8 场(楼下老妇被流弹打死)示范:"它从'棋盘'上剧情发展顺序来看并不需要,但对跟随观众的兴趣线来说至关重要。"
  5. 插入另一条线可以制造"省略法"(ellipsis)——时间已逝的印象,让同一批人物"实际上无法那么快经历之"地重新出现。
  6. 没有一场戏是专为呈示部(exposition)撰写的。"如果你需要传递事实的话,那么就把事实置于一个充满情感的语境中。"(Douglas 中译 p0119)
  7. 规划时把各线分开,到写 teleplay 时才编织(Douglas 给新手的顺序,与她自己分析"Hearts and Souls"四层同时性调度时的顺序相反)。
  8. 线的交叉在有主题链接时最有效(Landau 1e),家庭是最强的链接;runner 可以长大成主线;serial 不必每集写到每个人;三条的逐例(Terriers 的三级升格、Game of Thrones 的轮换、Mad Men S6E11 Peggy 的老鼠与 elliptical storytelling)见 reference.md 第七节。

4.3 procedural 的 A/B 双轨(Ann Donahue,CSI: Miami,Douglas 第 3 章)

Ann Donahue 的 A=调查/B=情感双轨、"warm body by the end of Act One, within the first 17 pages",以及 The Good Wife / CSI / House 三种编剧室顺序见 reference.md 第七节。

4.4 两种替代破故事法(必须与 A/B/C 并列)

  • Wendy West(Dexter):播出无幕,剧集实际退回三幕;"We break the beats by character and then do a weave."白板上每个角色有开头中间结尾,不按幕 break,按角色 break,先 break 主角线——"The reversals tend to come where you'd expect — page 40 to 45 out of a 55-page script."
  • Glen Mazzara(The Walking Dead):明确拒绝 A/B/C——把 Rick 当 A、另一人当 B 再交织,"That doesn't always equal a theme. It just pushes the ball further on each one.";改问 "What is this episode about?"(女孩走出谷仓那集、畜栏被尸群冲破那集,每个人物在那个更大的故事里有自己的位置)。代价他自己说明了:次要人物可能永远只是次要人物。
  • Oberg 的折中:多线不等于 theme-led——若各线角色共享同一外部问题与同一目标,它是 plot-led 的 co-protagonist 结构(Stranger Things 的 A1 Joyce / A2 Hopper / A3 男孩们 / A4 Jonathan 其

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