sw-story-structure SKILL.md skillA
sw-story-structure from jtydhr88/screenwriting-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add jtydhr88/screenwriting-skills/sw-story-structure@git:20260912.ffb70c3Pins 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-story-structure/SKILL.md- Versions recorded
- 5
- Latest version
- git:20260912.ffb70c3, committed Sep 12, 2026
- First version recorded
- Sep 6, 2026
- Size
- 31,477 bytes
- Repository stars
- 1,971
- License
- MIT
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 (event/scene/sequence/act, inciting incident, progressive complications, crisis-climax-resolution, subplots, story triangle), Julian Hoxter's nine-beat model, Neill Hicks' three acts as attraction/anticipation/satisfaction, and Lu Jun's Chinese short-play structure (凤头猪肚豹尾, 起承转合, eight openings, eight endings…
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
# 故事结构（Story Structure） > **输出语言＝提问语言**；术语一律锚回原词，见 [sw-workflow/terms.md](../sw-workflow/terms.md)，不自创译名。 本 skill 合并六种结构体系：悉德·菲尔德《电影剧本写作基础》（范式/情节点）、布莱克·斯奈德《救猫咪》（BS2 十五节拍、演示板）、罗伯特·麦基《故事》（结构层级、故事三角、激励事件、进展纠葛、危机高潮结局）、霍克斯特《编剧的十二条法则》（九节拍、A/B 故事）、尼尔·希克斯《编剧的核心技巧》（三幕＝吸引力/预期/满意、十要素）、陆军《编剧理论与技法》（起承转合、开头八法、结尾八法、高潮病、转变八忌、变化六种）。它们互相兼容：**菲尔德给骨架，斯奈德给页码，麦基给原理，霍克斯特给节拍名，希克斯给观众心理，陆军给中国戏剧的实操手法。** 对照表、范例与逐片情节点见同目录 [reference.md](reference.md)。 --- ## 一、结构的层级（麦基） - **结构**＝对人物生活故事中一系列事件的选择，组合成战略序列，激发特定情感并表达特定人生观。 - **事件**＝变化，须通过**价值**（生/死、爱/恨、自由/奴役、真理/谎言……随时可正负转化的二元）表达。东非降雨是巧合不是故事事件；造雨者从冲突中撞出的雨才是。 - 层级：**节拍**（动作/反应的交替）→**场景**（相对连续时空中通过冲突表现的动作，使负荷价值的情境至少在一个层面转折；细微变化）→**序列**（2–5 个场景冲击力递增到顶峰；适中变化；给每个序列定题目）→**幕**（一系列序列以重大逆转的高潮场景为顶点）→**故事**（一系列幕，最后幕高潮＝故事高潮，变化**绝对而不可逆转**；场景/序列/幕的变化都可逆，E.T. 二幕死后复活）。 - **没有不含转折的场景**：开头记价值正负，结尾再记，相同就问"为什么要这场"——几乎总是为了解说→删掉并把信息编织到别处。 - 情节＝"在危险地形上航行"，所有故事都有情节。 ### 故事三角（决定你写哪种结构） - 顶端**大情节**（经典设计）：主动主人公、外部对抗、连续时间、因果连贯、闭合结局——"人类心智的镜像"，观众最多。 - 左角**小情节**（最小主义）：开放结局、内在冲突、被动主人公、多重主人公（《意外的旅客》《温馨家族》《征服者佩尔》）。 - 右角**反情节**：非线性时间、巧合、非连贯现实（《下班后》《周末》；兔子罗杰变二维一次就成规律）。 - 底线之下是**非情节**（静止）。 - 戒律：作家必须以写作为生、必须先精通经典形式（伯格曼费里尼戈达尔奥尔特曼都先精通大情节）、必须相信他所写的东西——"为不同而不同就像对商业法则的盲从一样空洞"。 …
Read the whole file at its exact version.
How to install
mdr add jtydhr88/screenwriting-skills/sw-story-structure@sha256:342aeeabd58cd404The 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.
[](https://markdownregistry.com/a/art_yrrpbtekka4ogzbw)
3 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 5 versions of this file, between Sep 6, 2026 and Sep 12, 2026, about one every 2 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260912.ffb70c3 latest | 2026-09-12 | ffb70c3 | 31,477 B | A | view · diff |
| git:20260912.1e3eec7 | 2026-09-12 | 1e3eec7 | 28,409 B | A | view · diff |
| git:20260912.24b95a6 | 2026-09-12 | 24b95a6 | 28,155 B | A | view · diff |
| git:20260912.3d28797 | 2026-09-12 | 3d28797 | 28,018 B | A | view · diff |
| git:20260906.8212533 | 2026-09-06 | 8212533 | 27,702 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (31477 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
jtydhr88/screenwriting-skills · 1,971 stars · license MIT · pushed 2026-10-03 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_yrrpbtekka4ogzbw GET https://markdownregistry.com/api/v1/resolve?ref=jtydhr88/screenwriting-skills/sw-story-structure GET https://markdownregistry.com/api/v1/blob/342aeeabd58cd40446d46673ca7ca8b7fadc38fe0ed8de518469ef8e87faa64a
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.