New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Sw Format Adaptation

by jtydhr88 in jtydhr88/screenwriting-skills

Screenplay format, page craft, the writing process and adaptation (剧本格式/写作流程/改编) — merged from Wendy Henson (spec format rules), Richard Walter (page craft, revision), Neill Hicks (selling vs…

MITAuto-check passedWriting & Content

Install Sw Format Adaptation

skills CLI
$ npx skills add jtydhr88/screenwriting-skills --skill sw-format-adaptation -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install jtydhr88/screenwriting-skills sw-format-adaptation --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/jtydhr88/screenwriting-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/screenwriting/skills/sw-format-adaptation .claude/skills/sw-format-adaptation && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
sw-format-adaptation
GitHub stars
1.6k
Token cost
~3.4k tokens
SKILL.md length
631 words
Files
2
Skills in repo
25
Repo updated
First seen
Licence
MIT

At a glance

Screenplay format, page craft, the writing process and adaptation (剧本格式/写作流程/改编) — merged from Wendy Henson (spec format rules), Richard Walter (page craft, revision), Neill Hicks (selling vs…

  • Works in 3 steps: "N 页"先读成"N 分钟的戏"。 → 中文每分钟字数：对白为主取 370–400… → 折算页 ＝ 非空白字数 ÷ 每分钟字数。
  • Formatting a spec script
  • SKILL.md covers 一、你写的是推销剧本，不是拍摄剧本, 二、格式硬规则（汉森/沃尔特/希克斯/霍克斯特/戴蒙德合并）, 二之二、版面规格、元素级约定与输出格式 and 三、动作段落怎么写好, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Sw Format Adaptation is an agent skill from jtydhr88/screenwriting-skills. Screenplay format, page craft, the writing process and adaptation (剧本格式/写作流程/改编) — merged from Wendy Henson (spec format rules), Richard Walter (page craft, revision), Neill Hicks (selling vs shooting script, draft chain), Syd Field (master shot, card method, adaptation as original work), Robert McKee (step outline → treatment → screenplay), Julian Hoxter (format elements, adaptation four questions), Diamond & Weissman (one-page nine-step) and Eric Bork — plus an exact typographic grid, element conventions…

Its SKILL.md is about 3.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `reference.md`).

It sits in Writing & Content, covering Creative writing and fiction. The repository describes itself as: Professional agent skills for screenwriting, television writing and dramaturgy. The licence is MIT.

When your agent uses it

  • Formatting a spec script
  • Choosing the output file format
  • Deciding what goes in action lines
  • Planning drafts and outlines

Example prompts

  • “/sw-format-adaptation”

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. "N 页"先读成"N 分钟的戏"。
  2. 中文每分钟字数：对白为主取 370–400 字／分钟；动作与反应多的（悬疑、动作、单机位喜剧）取 270–330 字／分钟。最低一档：以成段无声动作为主的稿件（默片式段落、长镜头行动戏、小津式事件画外）取 230–260 字／分钟——这类本子上 270…
  3. 折算页 ＝ 非空白字数 ÷ 每分钟字数。

What it can do on your machine

Read from SKILL.md and the folder at commit 51115f1. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Sw Format Adaptation loads about 3.4k tokens when it runs. Until then it costs about 253 tokens; SKILL.md has 631 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~253
When it runs · the whole SKILL.md, loaded when a task matches
~3.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from jtydhr88/screenwriting-skills at commit 51115f1, republished under its MIT licence (© jtydhr88). 631 words, ~3,437 tokens.

Download SKILL.mdSave it as .claude/skills/sw-format-adaptation/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
sw-format-adaptation
description
Screenplay format, page craft, the writing process and adaptation (剧本格式/写作流程/改编) — merged from Wendy Henson (spec format rules), Richard Walter (page craft, revision), Neill Hicks (selling vs shooting script, draft chain), Syd Field (master shot, card method, adaptation as original work), Robert McKee (step outline → treatment → screenplay), Julian Hoxter (format elements, adaptation four questions), Diamond & Weissman (one-page nine-step) and Eric Bork — plus an exact typographic grid, element conventions (V.O./O.S., MORE/CONT'D, dual dialogue), a machine-writable output contract (Fountain, with forced markers for Chinese), and Asian industry formats (Chinese 场号制 影视剧本格式, Japanese 柱・ト書き・セリフ / 決定稿). Use when formatting a spec script, choosing the output file format, deciding what goes in action lines, planning drafts and outlines, cutting pages, adapting a novel, play or true story, writing a Chinese TV/film or Japanese-style script page, or preparing a submission-ready draft.

格式·流程·改编（Format, Process & Adaptation）

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

三件事：页面上怎么写（格式与动作段落）、从想法到成稿怎么走（大纲/处理台本/草稿链/修改）、改编别人的素材怎么办。来源：汉森《编剧：步步为营》、沃尔特《剧本》、希克斯《编剧的核心技巧》、菲尔德《电影剧本写作基础》、麦基《故事》、霍克斯特《编剧的十二条法则》、戴蒙德&韦斯曼《好莱坞编剧的生意经》、博克《如何写出好故事》。范例与符号表见 reference.md。行业与买卖见 sw-industry-business。

一、你写的是推销剧本，不是拍摄剧本

  • 希克斯：格式来自过时的制片厂拍摄剧本；你现在写的是推销剧本（selling script），避免无用缩写数字标示；最基本法则：让剧本容易读——不要让读者努力用功，不要让他翻回前页查场景如何来的；"你要操控的是阅读者，不是电影"。
  • 米利厄斯："我绝不写镜头内容，不写'我们去接近''我们可以看到'，那极为冒失。格式只需告诉读者白天晚上内景外景，其余像小说——清楚明确令人有阅读的兴趣。"
  • 汉森：格式不正确没人接受，审读人先扫前几页格式对才读内容；"不要给别人任何一个不读你剧本的理由"；剧本是导向制作的"蓝图"，观众不读剧本。
  • 沃尔特原理 32：想让别人把你当专业剧作家先用专业标准要求自己；"只要看上去像个作家写的就行"（博格）；忠实遵守画面声音限制几乎可不在乎格式。
  • 戴蒙德：只读剧本（好的烂的拍的没拍的），网上几千部免费剧本；但汉森/沃尔特提醒：网上多是分镜头拍摄脚本，别模仿其镜头术语。

二、格式硬规则（汉森/沃尔特/希克斯/霍克斯特/戴蒙德合并）

  • 字体页数：Courier 12（一页≈一分钟）；100–110 页理想，90–120 可接受，<80 外行，>125 "大家认为你不会写"，130 失控；不改字号骗页数。
  • 封面：只写片名与作者（未签经纪人可加联系方式）；不写日期、稿次、WGA 注册号、"原创剧本"、插图；两个铜插钉。
  • 页码从第二页右上角；不标场号、不写"未完待续"；"淡入："只在开头，"淡出"只在结尾。
  • 场景标题：内/外＋地点＋日/夜，大写；从概括到具体（"内景，朗博球场，更衣室——日"）；细节（日期钟点）放动作段落；可写"深夜""傍晚"帮读者理解。
  • 动作段落：现在时、主动语态（"乔被保罗带着"→"保罗带着乔"）；像列表不像描述；先时间季节天气再地点物理特征；只写摄影机能拍演员能演的（"她站在那儿思考着"拍不到）；删形容词副词；人物首次出现大写并附年龄；道具与合成音效大写（提醒制片经理与录音师）；声效只写看不见来源的（雷声、电话铃、画外狗吠）；段落间双倍行距，"一页剧本不是一堵文字墙"。
  • 永远不提摄影机：无 CU/POV/切/叠化/"我们看到/听到"；用文本暗示镜头（场景标题＝广角，旗帜＝中景，达伦走向麦克风＝特写）；每场结尾自然是切，不写"切至"（去掉可减十页）；淡入淡出叠化极少需要时全大写；P.O.V. 只在望远镜/主观镜头等必要处。
  • 只写主场景（master scene）：具有思想和动作连续性的戏剧化情节可涉多地点（乔治和马莎从客厅吵到卧室门到落地窗仍是一场"室内 乔治和马莎的家"）；间谍热狗摊接头只写全景＋必要细节，分解镜头是剪辑师的事。
  • 对白：距页左约 2.5 英寸起、栏宽约 3.5 英寸的左对齐窄栏（不是页面居中；汉森原书"距左缘 3 英寸宽 3.25 英寸"是同一栏的另一种量法），完整版面规格见下一节；人物名大写；不断页（用动作或他人插话打断，实在不行"（另见下页）"）；台词延伸过页＝"哈姆雷特综合征"；括号附加说明≤3 词只用动词（微笑/紧张），99% 不需要，多人场面需说明对谁说例外；不划线强调、不用惊叹号、省略号一次两次可第三次太多；（OS）画外台词、（VO）旁白尽量避免；不写方言音译；台词必须是一句话不能是呻吟哼哈（"S. or N."）。
  • 人物介绍：只给性别与年龄（沃尔特）；用抽象特色动作形容（"干枯皱缩的脸像干掉的柿子"）不写身高体重肤色除非整体性要求；不写人物表、人物小传、选角建议；名字显示性别、避免同音同首字母。
  • 转场依据：地点或时间转变、增减人物、改变戏剧目的。
  • 特效只写观众看到什么；蒙太奇先考虑避免，作为把复杂连续场面简单化的工具可写"追逐"列显著特征（十三页缩到五分之一页）。
  • 闪回：理想上不写"闪回"字样；担心读者不清楚可标"外景 谷仓 闪回"——"类似作弊的手段"；作弊（指明这是老板/这两人是姐妹）可自然少量做；"温和地提醒"（"简妮，我们前面看到的那个在洗衣店破坏自动贩卖机的女人"）允许。
  • 电邮提交：PDF 不是 Word；不标明专为电视写。
  • 拼写标点：老学究，纸质字典；"从未见过对白闪光角色难忘的剧本在格式拼写语法标点上乱七八糟"。

二之二、版面规格、元素级约定与输出格式

本节数字来自对多部专业排版剧本（US Letter、Courier 12）的实测与 Final Draft 默认模板，元素级约定与中日行业格式为行业通行做法，不出自本 skill 的 19 本来源书（由 issue #2 提议补入）。范例见 reference.md 第十节。

版面规格表（US Letter，Courier 12：每英寸 10 字符、每英寸 6 行）
元素距页左起点宽度 / 右止备注
页边距左 1.5"，右 1.0"，上 1.0"，下 1.0"每页约 55 行左边宽是为装订
场景标题1.5"（顶格）到 7.5"，约 60 字符全大写；前空两行（部分模板一行）
动作段落1.5"（顶格）6.0" 宽，约 60 字符段间空一行
人物名3.7"（约第 22 字符位）不居中，固定缩进后接扩展 (V.O.)/(O.S.)/(CONT'D)
括注3.1"约 2.0" 宽单行，动词为主
对白2.5"3.5" 宽（到 6.0"），约 35 字符左对齐窄栏，栏内单倍行距
转场右对齐到 7.5"起于约 6.0"CUT TO: 全大写带冒号
页码右上角，7.0"–7.5"，距顶 0.5"形如 2.第二页起

一页≈一分钟的换算就建立在这张表上；改任何一项都会让页数失真。

中文稿的"页"怎么算（这条与媒介无关：是中英版面之别，不是电影与剧集之别）

上面那张表是 US Letter ＋ Courier 12 的西文版面。中文不是等宽 10 字符／英寸，没有人物名 3.7″ 缩进，整张表的前件都不成立，所以"一页≈一分钟"不能直接拿来数中文稿。中文剧本没有页数标准，只有字数标准，而甲方、平台和各种写作指南又都在用"页"说话。统一按下面这条链换算，用时必须声明是折算页：

  1. "N 页"先读成"N 分钟的戏"。
  2. 中文每分钟字数：对白为主取 370–400 字／分钟；动作与反应多的（悬疑、动作、单机位喜剧）取 270–330 字／分钟。最低一档：以成段无声动作为主的稿件（默片式段落、长镜头行动戏、小津式事件画外）取 230–260 字／分钟——这类本子上 270 仍偏高，会把实拍时长系统性低估。取这一档时必须在交付件里写明折算依据（哪几场按无声动作计、字数 ÷ 每分钟字数 ＝ 折算页）。
  3. 折算页 ＝ 非空白字数 ÷ 每分钟字数。

长片与剧集都用这一条：100 分钟长片按 330 字／分钟约 3.3 万字；45 分钟剧集约 1.5 万字；28 分钟半小时剧约 9,200 字。不要去剧集 skill 里借这条链，也不要把某一种体量的字数当成另一种的标准——每分钟字数随对白密度变，不随媒介变。

出处与更细的分档（国产剧各类型的单集字数实测）见 sw-chinese-series-practice；那里给的是剧集的具体数字，换算原理在这里。

元素级约定
  • (V.O.)：说话者不在场景空间内——旁白、电话另一端、录音、内心独白。(O.S.)：在场景空间内但画面外（隔壁房间、门外）。电视稿常用 (O.C.) 等同 O.S.。可少用，但用时必须写对。
  • (CONT'D)：同一人物的对白被动作段打断后继续，人物名后加；跨页时页底加 (MORE)，下页人物名后 (CONT'D)——写作软件自动加，手写稿宁可调整分页。
  • (PRE-LAP)：下一场的声音先入本场结尾。(INTO PHONE) / (ON PHONE) 作括注；电话对方不可见用 (V.O.)，可加 (FILTERED)。
  • 双人对白（dual dialogue）：两人同时说，并排两栏；Fountain 里在第二个人物名后加 ^。
  • 蒙太奇 / 系列镜头：MONTAGE - 标题 起，每条一行以 -- 开头，END MONTAGE 或 BACK TO SCENE 收；SERIES OF SHOTS 同理。仍遵守前文"能避免就避免"。
  • 交叉剪辑：INTERCUT - 甲地 / 乙地 后自由切换，不再重写场景标题。
  • 闪回：场景标题前缀 FLASHBACK - 或用 BEGIN FLASHBACK / END FLASHBACK 包住。
  • 字幕：SUPER: "十八号"（动作段内）。
  • 声效与新出场人物在动作段内全大写（英文稿）；中文稿用加粗或不标，一稿统一。
输出格式契约：Fountain

由 agent 产出的剧本默认以 Fountain 纯文本交付（.fountain），不是 Markdown、不是手敲空格的 txt。理由：Fountain 的元素与上表一一对应，可版本管理，能渲染成 PDF 或导出 .fdx。

核心记号（完整规范见 fountain.io）：

  • 扉页：文件开头 Title: Credit: Author: Draft date: Contact: 键值对，空一行后正文。
  • 场景标题：以 INT. EXT. INT./EXT. I/E 开头的行自动识别；强制用行首 .（如 .内 沈越家·客厅 夜）。
  • 人物名：前有空行的全大写行自动识别；强制用行首 @（如 @沈越）。扩展直接跟在名后：@小七 (V.O.)。双人对白第二人名后加 ^。
  • 括注：人物名下一行的 (……)。对白：人物名后连续行，空行结束。
  • 转场：以 TO: 结尾的全大写行自动识别；强制用行首 >（如 > 切至：）。居中：> 剧终 <。
  • 动作：其余段落；强制用行首 !。分页 ===；注释 [[…]]；废稿 /* … */；章节 #；梗概 =；歌词 ~。

中文稿必须用强制记号：Fountain 靠大写和 INT./EXT. 识别元素，中文两者都不成立；所有场景标题加 .、所有人物名加 @、所有转场加 >，否则渲染出来全是动作段。

渲染路径：Fountain → PDF：afterwriting（命令行）、Beat（macOS，免费）、Highland、Slugline；Fountain → .fdx：Fade In、Final Draft 直接导入，或 afterwriting 导出。中文渲染需指定 CJK 等宽字体（Sarasa Mono、Noto Sans Mono CJK），Courier 没有中文字形。

与 sw-workflow 的衔接：阶段 5 的交付物按体例走——好莱坞式交 .fountain 文件，中文场号制与日式交纯文本，戏曲本子走戏曲 skill 的体例；story-bible 只记文件名与页数。

中文影视剧本：场号制

现代中文电影/剧集行业稿的通行结构（各公司细节不同，一稿内统一即可；范例见 reference.md）：

  • 场景行：场号 时 内/外 地点，如 1. 日 内 沈越家·客厅；剧集用 集-场（3-12）。时用 日/夜/晨/黄昏；顺序"日 内"或"内 日"两派，选一种。
  • 人物行（可选）：人物：沈越、小七，列本场出场者。
  • 动作段：段首 △（也有用 ▲ 或不加），现在时，一段一个动作单位。
  • 对白：人名：台词，括注放人名后 沈越（低声）：；画外音标 （OS）/（画外），旁白 （VO）/（旁白）。
  • 不写转场；闪回在场景行加 （回忆）；字幕写 字幕：。
  • 剧集每集 40–45 分钟约 1.2–1.5 万字；分场大纲（每场一行）是场号制的前身，与 sw-story-structure 的步骤大纲同物。
  • 场号制不用 Fountain，直接纯文本交付；agent 输出前先问用户要好莱坞式还是场号制；问不到人时按语言定默认值：全中文对白的项目用场号制，英文项目用好莱坞式／Fountain，并在交付件开头声明体例。不要因为无法提问就停下来。戏曲本子例外：这条默认值只管电影与剧集；戏曲（京剧、豫剧、越剧、昆曲……）的体例是唱／白／科介与板式或曲牌标记，不用场号制也不用 Fountain，见 sw-chinese-opera-banqiang 第九节、sw-chinese-opera-qupai。
日式剧本：柱・ト書き・セリフ
  • 柱（はしら）：场景行，○地点（时间），如 ○沈越の部屋・居間（夜）；场号可写在 ○ 前。
  • ト書き：动作描写，段首空三个全角字；人物初次登场附年龄 沈越（３４）；时间经过用 　　×　　×　　×；停顿写 （間）。
  • セリフ：人物名「台词」，人名后直接接全角引号，不用冒号；括注写在名后 小七（声）「…」；（Ｎ） 旁白、（Ｍ） 独白、（回想） 加在柱上。
  • 稿次：準備稿 → 改訂稿 → 決定稿，写在封面；印刷为竖排，文本文件横排即可。
  • 企画书（策划书）格式见 reference.md 第九节，与剧本格式是两种文档。
Show full SKILL.md (250 more words)Show less

三、动作段落怎么写好

  • 麦基：绝对现在时＋连续生动运动；具体名词（尖铁钉不是大钉子）、动作动词（pad/amble/stroll/mosey/saunter/stagger/tiptoe/creep/shuffle/waddle/trudge/lurch/hobble 不是"慢慢移动"）；通篇不用 is/are（"一座宅邸守卫着村头"）；海明威法回避拉丁抽象词与形容词副词；比喻须过"银幕上看见/听见了什么"检验；删"我们看见/听见"；用单倍行距小段落暗示镜头变化（广角→跟拍→字条特写→戒指特写→中景）。
  • 沃尔特符号：Hwk?/See/Hear（"这个真相使夏琳想起母亲多年虐待"观众怎么看出？）；Ess. Det. Only / SIFYN（熏牛肉香味留给你的小说；哈德逊河谷盛宴→"草坪上正在举办豪华舞会"）；Drekt/Akt（不写"停顿并若有所思"）；Notnot（不写"没有回答""什么都没做"）；Prez（"房间是空的"不写"每个人都离开了"）；Novry（"非常快"→狂跑急奔飞跑）；Conk（具体）；No Tt（不像人猿泰山"拿起枪。走到窗口。上膛。"）；4 v. 6（需要与不需要的词数比，"以这种比例削减一百一十页将减少五十六页"）；Fmpmt（找到要点说明要点让故事前进，"哈瑞离开了"两个词）；NoFX（无居中右对齐斜体粗体彩色）；Clok（这段在银幕上占多少时间？连一分钟无戏剧性都滞重）。
  • 汉森：两周内每句≤10 词，删连词从句形容词副词保留及物动词；"帕姆在洗衣房叠衣服。电话铃响帕姆飞快跑去厨房拿起话筒。无人应答帕姆挂了电话。"；从已拍剧本原稿学简洁（《异形 II》两版对比）。
  • 戴蒙德："他摸向后兜拿出钱包掏出一张 5 美元交给她"→"他掏出钱包递给她 5 美元"；测试：向朋友描述这个场景，细节不超过讲故事时的描述；不替导演美术服装配乐做工作。
  • 希克斯：写影像（images）不写影片画面（pictures）；"激起内心想象力不是形容画面"；写有因果关系有开端发展结尾的动作给读者节奏感（雪车追逐反例）；表现手法＝脉络在调子上的表现，第一场戏给读者如何读剧本的线索（好莱坞最普遍抱怨是剧本被误读）。

四、从想法到成稿的流程

动笔前
  • 博克 60/30/10：成功 60% 取决于核心想法，30% 结构，10% 表述；先把想法写成一两句日志＋一页摘要找客观反馈，用 PROBLEM 七要素自检（见 sw-premise-theme）。
  • 戴蒙德流程：三个 C（角色/概念/背景）→范例片单→一页九步剧情简介→角色动作表（从每个角色视角把九步各讲一遍）→剧情整合＋过场戏＋副线＋搞笑担当→大纲→桥段→剧本→修改→提交。"在提案/详情/大纲搞定各方前不要动笔。"
  • 汉森：主旨陈述（主题→基本动作＋目的句）＋戏剧性前提三句（干扰事件/第一幕钩子/第二幕钩子各附核心问题）写在一张纸上做大纲；写不顺＝构思有洞或被次要情节带偏。
  • 沃尔特：大纲≠梗概（梗概剥夺乐趣且未完成剧本的梗概不被重视）；写大纲"好比用水桶盛蒸汽"是最艰巨最必要的；大纲应含一些具体对白；原理 44：大纲是过去时；剧本是现在时——"真正的问题不是偏离而是遵循轨道"；场景卡片（编号索引卡，约六十个场景，每个场景自成迷你电影）便于实验；写到三分之二卡住时回头把故事重新做成卡片。
  • 麦基："从里到外"：六个月中前四个月写 3×5 卡片步骤大纲（每场一两句，背面标结构位置；目的是毁掉自己的作品，一个场景素描十几种再抛弃）→聊故事十分钟观察听者眼睛→处理台本（60–90 页，现在时逐刻描写，不写对白，写出潜文本）→剧本（每天五到十页，对白此时最好）。跳过程序直接写剧本＝冒牌的处理台本，也是最慢的方法；"未成熟的对白写作会窒息创造力"。
  • 菲尔德卡片法：第一幕一天、第二幕两天、第三幕一天；先做开端/两情节点/结尾四个段落。
  • 希克斯草稿链：沙发写作→大纲（"观象草图"）→散文式处理（现在式）→纳入所有事项的初稿（至少百页，不止一稿）→修订稿（删演员指引、删家具、改一般现在时、校对）→经纪人稿（只给懂剧本的批评者看）→上市稿。
  • 霍克斯特：大纲给自己（逐场，按你用的幕结构）；小样（treatment）给买家（散文、按电影腔调写，喜剧小样要好笑，4–30 页）；奥古斯特《大鱼》段落大纲示例。戴蒙德：提案文件最好 20 分钟以内；不能卖叙事形式的详情，主流只买完整剧本。
写作习惯
  • 汤米·汤普森："每天都要把衣服穿好"；沃尔特原理 41：写作障碍是写作的自然状态，"作家没有想写才写的权利"；原理 42：最后截止期限是作家的朋友；原理 43：不要让精益求精变成拦路虎；"作家在哪里写作没有他写什么重要"；每天先修改前一天的一页再写新的，别每天从头修改（开头像黄铜后端松散）；科波拉每页字面朝下不改到写完。
  • 菲尔德：每天两三小时一周四天一天三页；"如果犹豫不决，那就写"；初稿宁长勿短（180–200 页）；三阶段写下来（6–8 周）→压缩到 130–140 页→润色；卡住时问"接着要发生什么"、回人物传记、一个场面五个角度写五遍。
  • 霍克斯特：每日收工前启动新场景；不必按顺序写；重大变动先改大纲；一气呵成。戴蒙德："欲速则不达"，动笔前允许一两天拖延清空杂念；每天先重读前一天的。
  • 博克：找想法多列清单交叉配对，每天 15 分钟，先产量后筛选。
修改
  • 沃尔特原理 46：真正的写作特别是电影写作是修改；"好，但是……"应对制片人要求；原理 47：学会乐于删舍；原理 48：只要有疑问就把它扔掉；实验（证实需要摒弃也是成功）；把愤怒留在剧本中。
  • 戴蒙德：初稿"正常人都不会买"；先大概念（三 C、论点、类型预期）再细节；托马斯太太式修改（每个次要角色独特视角与声音，脑中选角）；删减：掐头去尾（"只有引入明确目标并得到支持或阻碍，场景才真正开始"）、砍无目的场景、每页删两三行不损失力度（《关岛登月》几小时删五页导演看不出）、节奏比页数重要；尽力前不给业内人看。
  • 霍克斯特：技术检查（错别字格式前后一致）→创作检查（精简描述、统一声音）→按目标逐项检修（第二幕通常是问题）；保存每个版本；打印出来改；弧线标记对照大纲。
  • 汉森：人物小传用清单；六人读五人喜欢则安全，五人说无力就重来。
  • 菲尔德："最佳场面"卷宗；"如果你对场面是否有效没有把握，那它大概是不会起作用的"；给两个会说真话的朋友看，不要四个。

五、改编

  • 菲尔德："苹果与桔子"——改编剧本＝以原素材为起点的独创剧本，不必忠实原著只忠实"原素材的整体性"；《总统班底》在原书一半处结束；科波拉逐字忠实《盖茨比》→"视觉上极其辉煌的一次失败"；小说写内在生活，戏剧写语言，剧本写外部情境；改舞台剧把对白里提到的事件视觉化；历史剧人物不必准确事件及结果要准确；传记只选几个事件（女主编以那条新闻为钩子）；新闻从特殊到一般，剧本从一般到特殊；灾难小说从第 278 页冰川测量开始，第三幕全新。
  • 麦基：原则一——小说越纯（内心冲突）戏剧越纯（个人冲突）电影就越差；选三层面冲突且强调个人—外界的作品（《桂河桥》）；方法：反复读原作不记笔记直到"闻到古龙香水味"，每事件缩为一两句，问"这是不是讲得好的故事"（十有九回不是）；原则二——愿意再创造：重排时间、步骤大纲、删场加场、为内心冲突找视觉表达；福尔曼"把你的孩子再生第二次"；"摄影机拍不了思维"，小说家把最好的语言给叙述者而非场景对白，要改编就得从里到外重新发明。
  • 霍克斯特四问：有授权吗（没有别干）？能拍成电影吗（视觉）？原媒介特殊性（漫画的格与页）？主题象征体系可借鉴？方法：先"原样照搬"写大纲再剪裁。
  • 博克改编真实事件：现实不具备故事结构，需整理编辑操纵夸大添加虚构；两个主要问题——目标为何重要、过程有多艰难（"险象环生的过程"成就电影）；《逃离德黑兰》机场实际无战斗；约斯特方法：熟悉素材→决定讲什么故事→一气呵成→回头对照研究。
  • 希克斯真人故事：先征询律师，请主题人物签《人生故事期权合约》；"别以为写妹妹或叔叔就自动拥有授权"；公众人物有权利，非公众人物隐私权极重要。
  • 沃尔特：改编畅销小说常令人失望（电影无法妥善处理幻想；能数出衬衫纽扣却不可能与脑中多变观念一致）；"编造甜蜜的谎言而非真实"。
  • 陆军改造素材学莎翁五法（提高次要人物思想、重新定位反面人物、加强主角智慧删其忍从、补合理性漏洞并顺带写性格、重设结尾让全部人物站到一条线上急速收场）见 sw-premise-theme。
  • 改编成剧集（小说/IP/真实事件/外国剧 → 长剧的扩写方向）与片段改编（成片 → 8–20 分钟舞台片段的压缩方向）是两套相反的工艺，见 sw-chinese-series-practice 的改编两节（张巍五源类型学与"卖点迁移"、赵彬彬四法则与主场景合并）；剧集改编的引擎判断见 sw-series-engine-bible。

六、诊断清单（按体例分四组）

先定体例，再跑清单。 旧版这份清单整篇按好莱坞长片写，写中文场号制的人逐条跑会几乎全条不过——那不是稿子有问题，是清单用错了。现在分四组：A 组三种体例都跑；B／C／D 三组只跑你实际采用的那一种。

A. 通用（与体例、与媒介都无关，三种都跑）
  1. 动作段落：现在时、主动语态、无 is/are、具体名词与动作动词、无镜头术语、无"我们看到"、无"想／回忆／意识到"这类拍不出来的内心、无"没有回答"这类否定式、每句尽量 ≤10 词？
  2. 每段动作在银幕上占多少秒？ 值得观众掏钱吗？有目的、有价值、是讲这件事的最好方式吗（3 Strikes）？
  3. 场景标题的逻辑（不论写成哪种体例）：要素齐、从概括到具体、钟点与日期这类细节放在动作段落而不是标题里？
  4. 对白的手艺：不写方言音译、不写哼哈与呻吟、不靠标点加重（下划线、惊叹号、省略号第三次）、括注 ≤3 词且只用动词且 99% 的情况下删掉？
  5. 人物介绍：只给性别、年龄和一个特色动作；不写人物表、人物小传、选角建议？
  6. 只写主场景？蒙太奇能否避免、或压缩成"一个题目＋若干显著特征"？闪回是否最少、且读者不会看错时空？
  7. 动笔前有没有一页简介／主旨陈述／戏剧性前提／角色动作表／步骤大纲？跟人聊过十分钟吗？
  8. 处理台本或大纲是否含潜文本而不含对白？文档链跳过了哪一步、为什么？
  9. 修改是否先大概念后细节？删了掐头去尾？次要角色各有自己的声音？节奏比页数优先？
  10. 改编：原素材的冲突主要在哪一层面？重新发明了什么？授权／期权签了吗？真实事件的"为什么重要"与"险象环生的过程"找到了吗？
  11. 篇幅：用的是哪种折算？中文稿按二之二的折算链（字数 ÷ 每分钟字数 ＝ 折算页）算过并在交付件里声明了吗？
  12. 体例是否全稿统一？有没有两种体例混用（例如场景行用场号制、动作段用好莱坞式）？
B. 好莱坞式（spec／Fountain，英文稿）
  1. 封面只有片名与作者？无场号、日期、稿次、注册号？Courier 12？页数 90–120？
  2. 版面对得上二之二那张表（左 1.5″、对白栏 2.5″ 起宽 3.5″、人物名 3.7″、转场右对齐）？
  3. 人物首次出现全大写并附年龄？道具与合成音效大写？
  4. 对白不断页；跨页有 (MORE) / (CONT'D)？
  5. (V.O.) 与 (O.S.) 用对了（不在场景空间内／在空间内但画面外）？
  6. 全篇不提摄影机、不写"切至"（每场结尾自然是切）？
  7. 交付的是 .fountain 纯文本，不是 Markdown、不是 Word？
C. 中文场号制（中文电影与剧集行业稿）
  1. 场景行写成 场号 时 内/外 地点（剧集写 集-场）？"日 内"或"内 日"两派选了一种并全稿统一？
  2. 动作段统一用 △（或统一用 ▲、或统一不加）？
  3. 对白写成 人名：台词，括注放在人名后（沈越（低声）：）？
  4. 画外音与旁白用 （OS）/（画外）、（VO）/（旁白），全稿一种写法？
  5. 不写转场、不写镜头术语？闪回在场景行加（回忆）？字幕写字幕：？
  6. 字数在区间内（剧集每集 40–45 分钟约 1.2–1.5 万字；其他体量按二之二的折算链算）？对白占比与类型相符？
  7. 交付的是纯文本（不走 Fountain，不用 Markdown 记号）？
  8. 有没有误用好莱坞的硬规则去判自己（Courier 12、90–120 页、全大写人物名）——这几条对中文稿不成立？
D. 日式（柱・ト書き・セリフ）
  1. 柱写成 ○地点・细部（时间），场号在 ○ 前？
  2. ト書き段首空三个全角字？人物初次登场附年龄（沈越（３４））？
  3. セリフ写成 人物名「台词」（名后直接接全角引号，不用冒号）？括注写在名后？
  4. 时间经过用 　　×　　×　　×？停顿写（間）？
  5. 旁白 （Ｎ）、独白 （Ｍ）、回想 （回想） 标在该标的位置？
  6. 稿次写在封面（準備稿 → 改訂稿 → 決定稿）？
体例没定怎么办

按二之二的默认值：全中文对白的项目用场号制，英文项目用好莱坞式／Fountain，日式只在明确要求时用；戏曲本子不在此列，走戏曲 skill 的体例；并在交付件开头一句声明体例与折算方式。不要因为没人可问就停下来。

七、工作流程：从想法到可提交稿

  1. 一两句日志＋一页摘要→找三个人反馈想法（博克/戴蒙德"这个我必须拿下"还是"好的我明白了"）。
  2. 三个 C＋范例片单＋一页九步简介＋论点（主题）。
  3. 主旨陈述与戏剧性前提（汉森）；角色动作表（戴蒙德）；三维档案（见 sw-character-conflict）。
  4. 步骤大纲/场景卡（麦基/菲尔德/沃尔特）：每场一两句，标价值转折；剧情整合＋过场戏＋副线＋桥段位置。
  5. 聊故事十分钟；处理台本（无对白有潜文本）或散文式处理。
  6. 初稿：每天页数计，宁长勿短，不回头修改超过前一页。
  7. 修订稿：删导演指示、家具、形容词副词；改现在时；每页删两三行；掐头去尾；托马斯太太式修改；技术检查。
  8. 经纪人稿：只给懂剧本的批评者；六人读五人喜欢。
  9. 上市稿：PDF；封面极简；WGA 注册（不写在封面）。

© jtydhr88, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in plugins/screenwriting/skills/sw-format-adaptation of jtydhr88/screenwriting-skills.

  • SKILL.md
  • reference.md

Open the folder on GitHubat commit 51115f1

Compare with similar skills

Sw Format Adaptation next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Sw Format Adaptation compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Sw Format Adaptation this skilljtydhr88/screenwriting-skills1.6k—~3.4kAutomated safety check: PassMIT
Story Multi-Perspective Reviewzenstory-ai/oh-story-claudecode7.4k3 repos~3kAutomated safety check: PassMIT
Short Web Fiction Trend Scanzenstory-ai/oh-story-claudecode7.4k2 repos~1.2kAutomated safety check: PassMIT
InkOS Creative HarnessNarcooo/inkos10k1 repos~1.1kAutomated safety check: PassAGPL-3.0
Novel Arteternityspring/shuohao-skills4.3k—~1.1kAutomated safety check: NotesApache-2.0
SepiaNanako0129/sepia3.1k—~3.6kAutomated safety check: PassMIT

Similar skills

  • Story Multi-Perspective Review

    zenstory-ai/oh-story-claudecode

    Reviews Chinese web-novel text with several reviewer agents in parallel, falling back to a single-agent pass, and reports structure, character, prose and setting problems with fixes.

    7.4k GitHub starsUsed in 3 repos~3k tokens
    Writing & ContentAuto-check passed

  • Short Web Fiction Trend Scan

    zenstory-ai/oh-story-claudecode

    Scans popular short web-fiction rankings on Chinese platforms such as Dianzhong and Heiyan to surface trending emotional hooks, themes and topic candidates with an expiry warning.

    7.4k GitHub starsUsed in 2 repos~1.2k tokens
    Writing & ContentAuto-check passed

  • InkOS Creative Harness

    Narcooo/inkos

    Drives long-form fiction, scripts, storyboards, interactive films and long-document translation through InkOS, with every change made by a typed action.

    10k GitHub starsUsed in 1 repo~1.1k tokens
    Writing & ContentAuto-check passed

  • Novel Art

    eternityspring/shuohao-skills

    给 AI 短剧出美术设定集（场景 + 叙事道具）：场景的设计意图、一致性锚点、光照时段变体、 空景提示词；道具的戏剧功能、状态变体、尺度参照、白底无手提示词。

    4.3k GitHub stars~1.1k tokensUpdated 2 days ago
    Writing & ContentAuto-check: notes

  • Sepia

    Nanako0129/sepia

    Make AI-generated writing read as human-written, in fiction and in professional prose.

    3.1k GitHub stars~3.6k tokensUpdated yesterday
    Writing & ContentAuto-check passed

  • Story Toolbox Router

    zenstory-ai/oh-story-claudecode

    Routes a Chinese web-novel writing request to the matching tool in a 13-skill toolbox, covers author habit memory, and can launch a local dashboard for browsing a project.

    7.4k GitHub stars~1.7k tokensUpdated today
    Writing & ContentAuto-check passed

More from jtydhr88/screenwriting-skills

All 25 skills in this repo

  • Ozu Screenplay Style

    jtydhr88/screenwriting-skills

    Writing screenplays in the style of Ozu Yasujiro and Noda Kogo (小津安二郎・野田高梧) — distilled from six complete screenplays (晚春 Late Spring, 麦秋 Early Summer, 东京物语 Tokyo Story, 浮草 Floating Weeds, 秋日和 Late…

    1.6k GitHub stars~2.9k tokensUpdated 8 days ago
    Auto-check passed

  • Sw Story Structure

    jtydhr88/screenwriting-skills

    Story structure for screenplays and stage plays (故事结构) — merged from Syd Field's paradigm and plot points, Blake Snyder's Save the Cat beat sheet and board, Robert McKee's Story…

    1.6k GitHub stars~3.2k tokensUpdated 8 days ago
    Auto-check passed

  • Chekhov Dramaturgy

    jtydhr88/screenwriting-skills

    Writing plays and screenplays in the Chekhovian mode (契诃夫戏剧法) — distilled from the complete plays (没有父亲的人/普拉东诺夫, 伊凡诺夫, 林妖→万尼亚舅舅, 海鸥, 三姊妹, 樱桃园, nine one-acts) plus Chekhov's own letters…

    1.6k GitHub stars~3.5k tokensUpdated 8 days ago
    Auto-check passed

  • Succession Series Writing

    jtydhr88/screenwriting-skills

    Writing a Succession-style ensemble series (继承之战群像剧写法) — distilled from Jesse Armstrong's complete shooting scripts for all four seasons, 39 episodes (Faber 2023), with his introductions and…

    1.6k GitHub stars~4.7k tokensUpdated 8 days ago
    Auto-check passed

  • Sw American Case Studies

    jtydhr88/screenwriting-skills

    Case studies of American screenwriting (美国电影剧作案例) — Mei Feng's readings of the Hollywood Western (value pairs, four oppositions), screwball comedy (strong heroine, buddy vs adversary two-hander)…

    1.6k GitHub stars~2.5k tokensUpdated 8 days ago
    Auto-check passed

  • Sw Character Conflict

    jtydhr88/screenwriting-skills

    Character creation, protagonist/antagonist design and dramatic conflict for scripts (人物/对手/冲突) — merged from Lajos Egri (three-dimensional character, orchestration, unity of opposites, pivotal…

    1.6k GitHub stars~3k tokensUpdated 8 days ago
    Auto-check passed

Categories

Questions about Sw Format Adaptation

What does Sw Format Adaptation do?

Screenplay format, page craft, the writing process and adaptation (剧本格式/写作流程/改编) — merged from Wendy Henson (spec format rules), Richard Walter (page craft, revision), Neill Hicks (selling vs…. Sw Format Adaptation is an agent skill from jtydhr88/screenwriting-skills.

When should I use Sw Format Adaptation?

Sw Format Adaptation fits situations like: formatting a spec script; choosing the output file format; deciding what goes in action lines; planning drafts and outlines.

How do I install Sw Format Adaptation in Claude Code?

Run `npx skills add jtydhr88/screenwriting-skills --skill sw-format-adaptation -a claude-code`. Or copy the skill folder (plugins/screenwriting/skills/sw-format-adaptation in jtydhr88/screenwriting-skills) into .claude/skills/sw-format-adaptation in your project. Claude Code loads it when a task matches its description.

How do I install Sw Format Adaptation in Codex?

Run `npx skills add jtydhr88/screenwriting-skills --skill sw-format-adaptation -a codex`. Or copy the skill folder (plugins/screenwriting/skills/sw-format-adaptation in jtydhr88/screenwriting-skills) into .agents/skills/sw-format-adaptation in your project. Codex loads it when a task matches its description.

Can I use Sw Format Adaptation in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add jtydhr88/screenwriting-skills --skill sw-format-adaptation -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/sw-format-adaptation, .gemini/skills/sw-format-adaptation, .github/skills/sw-format-adaptation and .opencode/skills/sw-format-adaptation in your project.

What does Sw Format Adaptation need to run?

SKILL.md names no scripts, command-line tools or credentials: Sw Format Adaptation is instructions for the agent only.

Does Sw Format Adaptation access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Sw Format Adaptation safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Sw Format Adaptation use?

Sw Format Adaptation is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Sw Format Adaptation use?

About 3.4k tokens (SKILL.md is roughly 14k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Sw Format Adaptation?

Skills that share tags, products or a category with Sw Format Adaptation: Story Multi-Perspective Review (zenstory-ai/oh-story-claudecode, 7.4k stars), Short Web Fiction Trend Scan (zenstory-ai/oh-story-claudecode, 7.4k stars), InkOS Creative Harness (Narcooo/inkos, 10k stars) and Novel Art (eternityspring/shuohao-skills, 4.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Sw Format Adaptation?

jtydhr88 (a GitHub user) maintains it in jtydhr88/screenwriting-skills, which has 1,621 GitHub stars. The repository holds 25 skills in this directory. The repository was last updated on October 3, 2026.

Source: jtydhr88/screenwriting-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.