SkillAgentSearch skills...

sw-sitcom-comedy

Half-hour television comedy craft (半小时情景喜剧/笑点力学/困境机器/多机位单机位格式) — merged from Evan S. Smith's Writing Television Sitcoms (premise-driven comedy in three levels, nine predicaments, six character mixes, setup/punchline mechanics, toppers, running gags, ten comedic nuances, format rules), Neil Landau's…

Install / Use

npx skills add jtydhr88/screenwriting-skills --skill sw-sitcom-comedy

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-sitcom-comedy

sw-sitcom-comedy scores 86/100 on our quality scale, 732nd of 1,155 Content & Media skills we index.

Its SKILL.md is 20 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-sitcom-comedy 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-sitcom-comedy compared with similar skills

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

SkillScoreStarsUpdatedFormat
sw-sitcom-comedy (this skill)by jtydhr88861.4k55d agoSKILL.md
siyuanby siyuan-note10047.3ktodayMCP Server
x402by browser-use100121.0k3d agoSKILL.md
algorithmic-artby anthropics100177.9k55d agoSKILL.md
pptxby anthropics100177.9k55d agoSKILL.md

Frequently asked questions

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

name: sw-sitcom-comedy description: Half-hour television comedy craft (半小时情景喜剧/笑点力学/困境机器/多机位单机位格式) — merged from Evan S. Smith's Writing Television Sitcoms (premise-driven comedy in three levels, nine predicaments, six character mixes, setup/punchline mechanics, toppers, running gags, ten comedic nuances, format rules), Neil Landau's sitcom seven-step formula and comedy-room models, Richard Blum's act-length and set-count parameters, Phoebe Waller-Bridge's Fleabag scripts (direct address as a season-long device, six-episode skeleton), Pamela Douglas on dramedy, Kam Miller on complementary comic traits, and Jesse Armstrong on jokes carrying tragedy. Use when writing or fixing a sitcom episode or spec, raising joke density per page, designing a comic predicament that generates stories, choosing between multi-camera and single-camera format and page counts, structuring cold open/acts/tag, writing a half-hour pilot, running a comedy punch-up, or making a drama funny without shifting genre.

半小时喜剧(Sitcom & Half-Hour Comedy)

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

核心命题:好笑不是后期往台词里塞的,是从故事前提里长出来的。 喜剧作者在三层上叠加张力——premise → sequence/scene → dialogue/action;种在前一层的喜剧会在后一层"自动产出更多、更大、更无缝的笑"(Smith《Writing Television Sitcoms》p0042)。所以第一个动作不是想笑话,是问"这个前提本身是不是一台 joke-producing machine"。

写半小时剧不是把一小时剧的参数改小,而是整体切换:页数、排版、场数、笑点密度、结构单位、人物关系的运转逻辑一起换。本 skill 管这套切换。通用方法不重写——对白见 sw-dialogue,场景价值转折见 sw-scene-craft,一小时剧幕结构与 act out 类型学见 sw-series-structure,引擎与 bible 见 sw-series-engine-bible,编剧室全貌见 sw-writers-room,Fleabag 逐集表见 sw-series-case-studies。

格式规范、笑点技法目录与结构模板见同目录 reference.md。

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

| 任务 | 读 | 跳过 | |---|---|---| | 判断一个喜剧点子成不成立 | 二(三层法与困境) | 六、十 | | 写或改笑点 | 三(笑话力学),例库转 reference.md | 四、九、十 | | 排半小时结构 | 四(含幕长/页码的选择规则) | 三、七 | | 选格式、定页数 | 六;中文稿先看 sw-chinese-series-practice 的页数折算 | 一–五 | | 直接对镜 / 装置喜剧 | 七 | 二、六 | | 诊断一份已有的喜剧稿 | 十二(诊断清单) | 其余 |

⚠️ reference.md 第一节是美式排版规范(字符位、边距、行距):写中文稿时整节不适用,不要读。


来源与各书关系

  • Smith《Writing Television Sitcoms》(Revised & Expanded, 2009)给全部骨架:三层法、九 predicament、六 character mix、笑话力学、beat 数与三幕页数、三套格式(Appendix A 按字符位给边距)、pilot 与 series format。本 skill 的编号体系基本是他的。
  • Landau《The TV Showrunner's Roadmap》1e Tip 21 给公式与页数表(七步公式、"恶狗追上树"、多机页数分配、多机 vs 单机差异);2e 第 13 章给喜剧编剧室(四种房间模型、alts 与 candy bag、table read 的功能之争)。
  • Blum《电视与银幕写作》第 11–12 章给制作约束:teaser/幕/tag 分钟数、多机格式规则、布景 3 个理想 5 个上限、一周拍摄计划。
  • Waller-Bridge《Fleabag: The Scriptures》给装置喜剧与六集季骨架;Douglas《Writing the TV Drama Series》3e 的 Dramedy 专题给边界;Miller《...And the Hero Succeeds》给 complementary traits;Armstrong《Succession》剧本集给"喜剧承载悲剧"。

一、半小时喜剧与一小时剧的区别:整体切换表

| 维度 | 半小时喜剧 | 一小时剧 | 出处 | |---|---|---|---| | 页数 | film/single-cam 27–30;tape/multi-cam 45–50;animation 40–50 | 48–63 | Smith, Appendix A;Landau 1e p0296 | | 幕 | cold open + 2 幕(多机)或 2–4 幕(单机)+ tag | teaser + 4/5/6 幕 | Landau 1e Tip 21 | | 幕长 | teaser 30–60 秒;每幕 10–12 分钟;tag ≤1 分钟 | 每幕 10–15 分钟 | Blum p0135 | | 第一幕 | 极短(30 页里 1–5 页),人物与世界已建立 | 约 1/4 | Smith p0121 | | 场数 | 多机一集 15–20 场、每幕 3–5 场、场面长;单机场多而短(HIMYM 常 40–50,有时 80) | 视格式 | Landau 1e Tip 21 | | 布景 | 3 个理想(1 主+2 副),上限 5 | 多得多 | Blum p0143 | | 结构单位 | beat:主线 5–9,subplot 3–5,thread 每条 3–6 | 场与 act out | Smith p0117–0119 | | 笑点密度 | 每页 2–4 个实笑点;多机几乎每句台词都被期待出笑话 | 仍需幽默视角 | Smith p0039/p0083 | | 赌注 | 小而对人物至关重要("tremendous trifle");"sitcoms are smaller" | 生死/职业/制度 | Landau 1e p0298;Smith p0119 | | 沉默 | 多机的沉默=dead air;单机的沉默可以 cringe "but in a good way" | 沉默是资源 | Landau 1e Tip 21 | | 人物成长 | 单集"自私→醒悟→学到教训……下集归零";长期靠扩展而非改变 | 跨季弧 | Smith p0139;Lloyd |

  1. 引擎是关系密度,不是事件。 Blum 记录制片人对"角色彼此之间的亲密程度"吹毛求疵,因为那是让喜剧稳步发展的关键(p0148)。Fleabag 第一集没有"事件把主角推进新处境",只是把一张互相伤害的关系网铺开。
  2. 多机与单机是两种写作动作,不是两种排版。 多机像舞台剧:场少、场长、必须不断设计人物在同一布景里的进出场(Michael Patrick King 认为多机更难,因为单机"you could just CUT TO: the next scene");单机像"每周一部小长片",靠碎片场面与交叉剪辑,更依赖视觉笑点。有高管认为两者有"HUGE creative differences"、招单机剧只看单机 spec——两种样本都要备。

二、premise-driven comedy:三层法

三句话(Smith p0092–93):① 把好笑的元素织进故事前提;② 在 sequence/scene 层剥削并复合它们;③ 从故事自带的幽默里长出对白与动作。"It's all about building rather than repairing."

2.1 第一层:premise 的四个喜剧来源

Predicaments/Character Mix/Style of Comedy/Casting(p0045–0061)。

困境是 joke-producing machine。 场景里的困境只管几页;织进 premise 的持续困境一直生产笑点直到它被解决,而且未解决的困境让观众带着期待看戏,连无关的笑话都显得更好笑(p0046)。系列永久困境(《Gilligan's Island》的"no phone, no lights, no motorcar")是找单集故事的第一处矿。前置条件:观众相信人物不会真受伤,且已被提示"这是喜剧"。

九种经典 predicament 与 六种 character mix 的名目、原例与使用限定见 reference.md §二。

2.2 "每个剧就是它自己的一个 genre"

子类别(domestic、odd couple)不是 genre:《Two and a Half Men》与《The Simpsons》都是家庭剧但属性完全不同,每个剧的 premise 规定一套观众期待的属性。写既有剧前先答风格问题清单:幽默主要来自困境、人物关系还是环境?belly laughs 还是 smiles-and-nods?视觉为主还是对白为主?结尾有爆发式 comedy run 还是全程均匀? 两个新手错误:Too Funny to Pass Up(再好笑也要扔掉不属于这个剧的点子);The Genre Shuffle("blending genres throughout is not the same as shifting")。最理想的一集 "expands (but does not change) a show's premise"。

2.3 第二层:sequence 与 scene 的复合

sequence=一串连续场景承载一个持续动作;scene=一个地点一段时间,地点或时间一变就是新场。三个动作: ① Compound Story Predicaments——在故事层复合困境,张力"不是翻倍而是指数级上升"(p0063);可叠同类(Big Lie → Bigger Lies)也可 Mix and Match;这一层的困境"more finite, occur in real time",在一个连续段落内出现—展开—解决。② Stir Up the Character Mix——临时结成"unnatural alliance",观众同时等故事困境解决和这个联盟崩溃,结尾恢复原有配比。 ③ 三条提醒:Escalation(升到结尾的 comedy climax,很多剧固定在每集末放一段 raucous comedy block);Look to the Series Premise(最好的故事来自主角的 foibles);Be Consistent(写对白前就检查各段落笑点强度——等你被自己的妙句迷住就晚了)。 人物学基础(Sheldon Bull):sitcom 人物"没有 self-edit button",行动更冲动,对常人能一笑置之的问题做出巨大反应。


三、笑话力学(第三层)

模型:setup(straight line)引入话题并暗示某种 complication/incongruity→制造张力;punchline 用意外方向的转折解决它→释放张力。"setups are the true unsung heroes"(p0068)。Smith 的限定必须一起记:这些术语的最大价值在改与修,不在造(editing and repairing, not creating)。

3.1 Setup 五条

  1. 平常可信——先用合理的 setup 把观众拉进来,再用意外的 punchline 敲头;setup 一显得古怪,观众就知道有埋伏。
  2. 两段式:至少含 ① 话题+ ② 一两拍 development(由 complication 或 incongruity 造成)。没有第二段,张力不够,punchline 只像补充信息。Smith 的对照实验(把《30 Rock》pilot 里 Jack 剖析 Liz 人生的长篇砍成一句)结论是"仍好笑但不如原来,而且显得更公开地敌意,不忠于人物"(p0071)——development 段同时决定笑点强度和人物真实度。
  3. 可以拆散铺远:各部分可散在一场戏里甚至提前几场埋好。
  4. 不许暗示:"You brought a whole beer keg."→"Yeah. Where can I fill it up?";多问一句"Is that thing full?"笑话就死了。
  5. 生活本身是半个 setup:共同的生活苦难与共享文化经验可充当第一段。

3.2 Punchline 六条

定义:"a sudden twist that makes both sense and nonsense"——它解决 setup,但来自观众被引导去期待的那个方向之外(p0077)。

  1. Last things last:punch word 放句尾。"I think that he thinks it's a paper for people who work. Daily." 远胜"it's a daily paper for people who work"。(同一原理见 sw-dialogue 的掉尾句。)
  2. Don't go past the joke:punchline 通常也在一段台词末尾,说完还接着说会踩坏它。例外:啰嗦是这个人物的节奏。
  3. Topper:一个 setup 出两三个递进 punchline("Sex."→"It's illegal... Next best thing."→"Torture.")。三条限制:最多 top 两次(再多观众会察觉);有些笑话该单独留着(承担戏剧时刻、控制节奏);dramedy 里通常不用 topper。
  4. Running gag / callback:一个完整笑话后面回来 2–3 次;回指原笑话的新 punchline 叫 callback。三种做法:同一人物在新情境重说/不同人物重说/不同人物说同一 setup 的变体。每次回来带第二层含义,最后一次常是反讽或反转收大笑。术语提醒:running gag 也叫 runner,但 runner 也常指"很小的 subplot",未必好笑。
  5. 卡住就回去改 setup(换一个 incongruity 或加大 contrast)——而不是继续磨 punchline。
  6. Go for Literal:取字面义("Call me a taxi." / "Okay, you're a taxi.")。literal joke 多出自极笨或极聪明的人物。

3.4 人物专属的笑法

十种 comedic nuance:Understated Response/Exaggerated Response/Irony/Nervous Babbling/Pulls No Punches/Space-Shot POV/Wordplay/Double Entendre(+两种情绪驱动的变体)。每一种是人物的固定笑法而不是作者的技巧库:写对白前先定这个人物用哪一两种,其余不给他。

3.5 五条通则

  • Hanging a lantern on it:让一个人物喊"That's crazy!"来让离谱设定过关(p0178)。不可信的事要先 foreshadow,并且种了种子就要收割。
  • Bigger Really Is Better:不是告诉邻居而是向全国广播老板秃头;不是冒犯一个同事而是给全办公室讲多元化。只要不违背人物天性与剧集前提,往大想。
  • Small Truths, Big Laughs:"Surf's up, Jim. Watch me ride this wave of inspiration! (GRINS, INTO PHONE) Yes, I'll hold."
  • Reiss 三条件:每个笑话必须同时好笑、服务剧情、不让人物变得讨厌;而且再难的位置也一定有一个笑话在那里,"你可能要找两小时,但你会找到"。

3.6 密度标准

每页 2–4 个实笑点(p0039/p0083)。执行方式不是估计而是数:用红笔圈出真笑点,不足就修;开头几场要逐个数——读者不会因为这是 pilot 就宽容,也不会等到第六页"喜剧才真正开始"(p0297)。另一端:没有制片人会说"这剧本太好笑了",但也不能 too jokey——笑点的量与类型从头到尾要稳定。观众反应分三档 smile / chuckle / laugh(肢体喜剧出 laugh,机智对白出 smile)。topper 与 running gag 是提高 joke count 最经济的手段。


四、半小时结构

4.1 beat sheet(一页)

主线 5–9 个 beats;每条 subplot 3–5 个;thread structure(Seinfeld 式四条等重线)每条 3–6 个。 beat=改变主角目标或抬高张力的时刻/发现/事件,常是"action→reaction"两半,缩写成一句:"Character One blabs secret—claims (new lie) to cover up."多线先各自列再编织;每个 beat 以中心人物的名字开头再改写成他的反应(Ellen Sandler)。这张纸上的故事如果不 build、不合逻辑、不好笑、不意外,就回画板。术语 flag:正剧剧组的"beat sheet"另指多页、编号场景、电报体的 outline。 术语 flag:正剧剧组的"beat sheet"另指多页、编号场景、电报体的 outline。

4.2 单主线的三幕与页码

典型路径:主角遇新问题/机会→用离谱(而非合理,否则没故事)的手段追求→障碍升级、目标更急迫→结尾反噬、暴露、难堪,"learns the error of his ways. Sort of." 第一幕极短(一两个 beat 内出 inciting incident);第二幕最长(占 1/2–2/3,"think development, not repetition",常以大揭示+重大抉择结尾);第三幕约 1/4(加速、升到高潮、对质、真相、解决)。 页数(film format 30 页、单主线):1–5 页/15–20 页/5–10 页。 thread 剧四条线各约 1/4(7–8 页),各幕落在哪页无法预言。

⚠️ 这组页码与切换表里"每幕 10–12 分钟"是两套互斥方案,对第一幕的要求差四倍(1–5 分钟 vs 10–12 分钟)。选择规则:先定幕数。

  • 两幕(cold open+2 幕+tag,多机位常见):每幕 10–12 分钟,第一幕不短。
  • 三幕单主线(film format 30 页):1–5/15–20/5–10 页,第一幕极短,因为人物与世界已建立。
  • pilot 例外:第 1 集要建世界与人物,第一幕必然长于 1–5 页,不要按这条判不合格。 诊断 ⑦ 只适用于三幕单主线的非 pilot 集。

4.4 dramatic structure vs broadcast format

"act"两义:戏剧结构的幕 vs 广告之间的段。广告位不一定与戏剧幕转合拍——广播意义上第一幕之后的那个广告,可能落在戏剧意义的第二幕中间。你在 outline/剧本里打的 ACT ONE, ACT TWO 是 broadcast format。做法:先 beat sheet,再在 outline 里把关键 plot point 挪到该剧惯常的广告位之前;不能全对齐也没关系,但能放大 beat 就放——新人在 spec 里写出强 act break 会大大加分。

4.5 Landau 的七步公式

七步全文(tremendous trifle 的定义、中点反转放在哪一幕末、恶狗追上树的比喻、tag 的功能)见 reference.md §三。

4.6 key dramatic moment 与 block comedy scene

Matt Williams:每集都要建向一个 key dramatic moment(决定/发现/和解),一切朝它走、再从它走开,而它九成落在 block comedy scene 里(p0126)。推论:先定这一刻,再决定它落在哪一场;那一场必须同时是本集最大的喜剧段落。

4.8 六集季(单一作者、流媒体半小时)

Fleabag 两季各 6 集的逐集骨架、单集 cold open → TITLES → 段落 → button 的模板、以及两条收尾规则(季终 button 解决主题;一件物件贯穿全季、每集换一次手)见 reference.md §四。


五、人物:谁值得被放进这台机器

  • 不必讨喜,但必须有 drive、purpose、软肋、独特技能——至少要有"some small spark of passion"(p0296)。Michael Scott 是自大又常刻薄的蠢蛋,但他是公司顶级销售,而且总想做对的事(然后没做到)。"in comedy, it's usually the troublemakers that we like best."
  • Proximity counts:前提里必须有某个场景或戏剧装置,定期把人物挤在一起,让他们一集又一集地互相撞上。不必又做办公室/客厅剧(单机允许到处跑),但这个装置不能缺。
  • 冲突要发生在常规人物之间:两个常驻角色为"卷纸该朝哪边挂"吵起来,观众就会看。
  • complementary traits(Miller):情景不好笑,人物才好笑——孵化器、公寓、医院、餐馆本身都不 funny。传统路线是亚里士多德式"imitation of men worse than the average"(It's Always Sunny、Curb);当代有一条 softening trend:complementary character traits(有缺陷但善意)更 relatable。Modern Family pilot 人物表的三个可复制做法:每人都用正面措辞描述;任意两人配对都能出笑点;每人的观点各有 validity。
  • 十种行为型人物:Supportive Parent/Idiot Savant/Idiot Idiot/Clown/Operator/Mentor/Confidant/Irritant/Romantic Interest/Critic。限定很重要:这些是临时行为模式而非固定标签——Frasier 这集对父亲是 supportive parent、下集是 childlike idiot。
  • 配角命名法(Fleabag):用一个特征命名并终身不改(Arsehole Guy、Bus Rodent、Bank Manager、Godmother),主角无名。命名方式本身要是主角的能力/缺陷——她一生都能把人缩成"一个公交老鼠"或"一个混蛋男"——所以后面要有一集让她为此付代价(Priest=她第一个无法贴标签的人)。

六、三套格式与页数硬指标

三套格式=live-action film(single-camera)/live-action tape(multi-camera)/animation;真正的区别是单机还是多机。写既有剧的 spec 就去拿那部剧的真剧本,精确复制版式。三套格式的页数、边距(按字符位)、行距、场景编号、进出场下划线、END OF COLD OPEN/END OF ACT ONE/TAG/END OF EPISODE 的标记写法、spec 刻意不写的项目、布景经济学与动画两条,见 reference.md §一。


七、直接对镜与装置喜剧(Fleabag)

直接对镜((to camera))不是风格而是人物的心理防御:她某天醒来发现有观众在看她,于是做了唯一能做的事——"she put on a show"(〈Who is Fleabag?〉)。这个定性决定了它能在第二季变成剧情。三种基本用法:旁白式铺陈("You know that feeling when...")/对话中间的一句内心批注(说 A,转头对我们说 B,再转回去说 C)/无声的一瞥("She looks at the camera." 作为反应镜头)。

  1. 装置先做可行性测试,再写剧本。 一年破不了改编难题,最后是 Vicky Jones 用手机拍她在厨房对镜头说话五分钟,放下手机:"It works."——把装置当成可测试的假设,而不是写作决定。
  2. 三连+第四拍由别人翻转。 先给形容词、再给证据,证据总比形容词低一档:"He's a feminist." / "I have a sister.";或"别说—别说—说了"(五拍内三次转头)。翻转权交给对手,不交给主角。
  3. 对镜头只说笑话,对人说真话。 全季给她一次且只有一次不对镜头的长独白(告解室),那就是全剧的情感最高点。
  4. **装置本身就

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars1.4k
CategoryContent
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