sw-format-adaptation SKILL.md skillA

sw-format-adaptation from jtydhr88/screenwriting-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add jtydhr88/screenwriting-skills/sw-format-adaptation@git:20260912.ffb70c3

Pins git:20260912.ffb70c3 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
jtydhr88/screenwriting-skills
Path
plugins/screenwriting/skills/sw-format-adaptation/SKILL.md
Versions recorded
7
Latest version
git:20260912.ffb70c3, committed Sep 12, 2026
First version recorded
Sep 6, 2026
Size
31,274 bytes
Repository stars
1,971
License
MIT

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…

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 格式·流程·改编(Format, Process & Adaptation)

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

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

---

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

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

---

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

- **字体页数**:Courier 12(一页≈一分钟);100–110 页理想,90–120 可接受,<80 外行,>125 "大家认为你不会写",130 失控;不改字号骗页数。
- **封面**:只写片名与作者(未签经纪人可加联系方式);不写日期、稿次、WGA 注册号、"原创剧本"、插图;两个铜插钉。
- **页码**从第二页右上角;不标场号、不写"未完待续";"淡入:"只在开头,"淡出"只在结尾。
- **场景标题**:内/外+地点+日/夜,大写;从概括到具体("内景,朗博球场,更衣室——日");细节(日期钟点)放动作段落;可写"深夜""傍晚"帮读者理解。
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add jtydhr88/screenwriting-skills/sw-format-adaptation@sha256:8e5b3459cb6adab0

The line at the top of this page pins the label git:20260912.ffb70c3, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_sal7epe3f4pwnpsw.svg)](https://markdownregistry.com/a/art_sal7epe3f4pwnpsw)

4 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 7 versions of this file, between Sep 6, 2026 and Sep 12, 2026, about one every day.

versioncommittedcommitsizeaudit
git:20260912.ffb70c3 latest2026-09-12 ffb70c3 31,274 BA view · diff
git:20260912.1e3eec72026-09-12 1e3eec7 30,917 BA view · diff
git:20260912.92022d22026-09-12 92022d2 30,477 BA view · diff
git:20260912.24b95a62026-09-12 24b95a6 30,817 BA view · diff
git:20260912.3d287972026-09-12 3d28797 30,680 BA view · diff
git:20260908.06577142026-09-08 0657714 25,835 BA view · diff
git:20260906.82125332026-09-06 8212533 18,540 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (31274 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

jtydhr88/screenwriting-skills · 1,971 stars · license MIT · pushed 2026-10-03 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_sal7epe3f4pwnpsw
GET https://markdownregistry.com/api/v1/resolve?ref=jtydhr88/screenwriting-skills/sw-format-adaptation
GET https://markdownregistry.com/api/v1/blob/8e5b3459cb6adab0da67284b5200ef58e8c447d516e1cc1bab37852e7ffe8911

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from jtydhr88/screenwriting-skills

chekhov-dramaturgy SKILL.md skill
jtydhr88/screenwriting-skills · plugins/screenwriting/skills/chekhov-dramaturgy/SKILL.md · Writing plays and screenplays in the Chekhovian mode (契诃夫戏剧法) — distilled from the complete plays (没有父亲的人/普拉东诺夫, 伊凡诺夫…
git:20260912.24b95a6 · audit A · 1,971 stars
ozu-screenplay-style SKILL.md skill
jtydhr88/screenwriting-skills · plugins/screenwriting/skills/ozu-screenplay-style/SKILL.md · Writing screenplays in the style of Ozu Yasujiro and Noda Kogo (小津安二郎・野田高梧) — distilled from six complete screenplays…
git:20260912.ffb70c3 · audit A · 1,971 stars
succession-series-writing SKILL.md skill
jtydhr88/screenwriting-skills · plugins/screenwriting/skills/succession-series-writing/SKILL.md · Writing a Succession-style ensemble series (继承之战群像剧写法) — distilled from Jesse Armstrong's complete shooting scripts for…
git:20260912.92022d2 · audit A · 1,971 stars
sw-american-case-studies SKILL.md skill
jtydhr88/screenwriting-skills · plugins/screenwriting/skills/sw-american-case-studies/SKILL.md · Case studies of American screenwriting (美国电影剧作案例) — Mei Feng's readings of the Hollywood Western (value pairs, four…
git:20260912.92022d2 · audit A · 1,971 stars
sw-character-conflict SKILL.md skill
jtydhr88/screenwriting-skills · plugins/screenwriting/skills/sw-character-conflict/SKILL.md · Character creation, protagonist/antagonist design and dramatic conflict for scripts (人物/对手/冲突) — merged from Lajos Egri…
git:20260912.ffb70c3 · audit A · 1,971 stars
sw-chinese-opera-banqiang-cases SKILL.md skill
jtydhr88/screenwriting-skills · plugins/screenwriting/skills/sw-chinese-opera-banqiang-cases/SKILL.md · Worked full-length scripts of banqiang-system Chinese opera with their creation records (板腔体全本语料库). Primary texts…
git:20261003.51115f1 · audit A · 1,971 stars
sw-chinese-opera-banqiang SKILL.md skill
jtydhr88/screenwriting-skills · plugins/screenwriting/skills/sw-chinese-opera-banqiang/SKILL.md · Playwriting for banqiang-system Chinese opera (板腔体:京剧、豫剧、越剧、秦腔、评剧、沪剧、淮剧、川剧弹戏), where sung passages are paired seven- or…
git:20261003.51115f1 · audit A · 1,971 stars
sw-chinese-opera-qupai-cases SKILL.md skill
jtydhr88/screenwriting-skills · plugins/screenwriting/skills/sw-chinese-opera-qupai-cases/SKILL.md · Worked qupai-system (曲牌体) opera scripts, act by act. Guan Hanqing's three surviving zaju (窦娥冤/救风尘/金线池 — twelve acts…
git:20260912.1e3eec7 · audit A · 1,971 stars
sw-chinese-opera-qupai SKILL.md skill
jtydhr88/screenwriting-skills · plugins/screenwriting/skills/sw-chinese-opera-qupai/SKILL.md · Chinese opera playwriting for the qupai (曲牌体) system — 元杂剧, 明清传奇, 昆曲, 川剧高腔, where sung text is filled into fixed tune…
git:20261003.51115f1 · audit A · 1,971 stars
sw-chinese-series-practice SKILL.md skill
jtydhr88/screenwriting-skills · plugins/screenwriting/skills/sw-chinese-series-practice/SKILL.md · Mainland-Chinese TV-series craft, documents and production chain (国产剧创作体系与制片链) — the China layer parallel to the…
git:20261003.51115f1 · audit A · 1,971 stars
sw-dialogue SKILL.md skill
jtydhr88/screenwriting-skills · plugins/screenwriting/skills/sw-dialogue/SKILL.md · Dialogue writing and revision for screen and stage (对白/台词/潜台词) — merged from Robert McKee's Dialogue (dialogue as…
git:20261003.51115f1 · audit A · 1,971 stars
sw-genre-anatomy SKILL.md skill
jtydhr88/screenwriting-skills · plugins/screenwriting/skills/sw-genre-anatomy/SKILL.md · Genre anatomy from John Truby's The Anatomy of Genres (类型解剖 / 类型节拍 / 混合类型 / 超越类型) — genres as beat systems with a life…
git:20261003.51115f1 · audit A · 1,971 stars

Every file in jtydhr88/screenwriting-skills

Browse by kind, by grade A, or by owner.