sw-truby-anatomy SKILL.md skillA

sw-truby-anatomy 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-truby-anatomy@git:20260914.cab203f

Pins git:20260914.cab203f 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-truby-anatomy/SKILL.md
Versions recorded
1
Latest version
git:20260914.cab203f, committed Sep 14, 2026
Size
20,735 bytes
Repository stars
1,971
License
MIT

Organic story anatomy from John Truby's The Anatomy of Story (有机结构/设计原则/22步骤/道德议题/四角对立/幽灵/场景编排) — the designing principle (story process plus original execution), the seven key steps as the organic spine, all twenty-two steps with the middle-act machinery the beat sheets lack (ghost, fake-ally opponent, plan, opponent's drive, ally's attack, fake defeat, three revelation-and-decision pairs, audience revelation, visit to death, moral decision), four-corner opposition, the moral-argument chain…

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

# 有机故事解剖(Truby's Organic Anatomy)

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

本 skill 提炼自约翰·特鲁比《故事写作大师班》(John Truby, *The Anatomy of Story*, 2007)。特鲁比的行业身份是"剧本医生"——替制片公司诊断别人剧本的结构病,这套方法就是诊断单本身:**设计原则、七大关键步骤、22 个步骤、四角对立、道德议题链、场景编排**。原书方法以《教父》《卡萨布兰卡》《窈窕淑男》等经典的逐步骤拆解为证,例证见 [reference.md](reference.md)。

## 一、与三幕页码体系的关系(先读)

**分歧并排保留**(本库约定):

- 特鲁比的立场:七大步骤"**不像三幕式结构等机械式故事结构那样,可以随意从外面强加于故事之上。它们存在于故事的内在**"(Ch3);22 个步骤"永远不会告诉你写什么,这是公式或类型才会要求你做的事"(Ch8)。
- 菲尔德/斯奈德的立场(`sw-story-structure`):结构=页码地图。一页一分钟,情节点、中点、失去一切落在第几页。

**两者不互斥,服务不同的问题**:页码地图管"多长、什么节奏",有机解剖管"骨架是否长在人物身上"。推荐两种用法任选其一、不要都做:

1. **先地图后校验**(最常用):BS2 演示板定稿后,用本 skill 查中段组件缺口(见第四、五节)与道德议题链(第七节)。
2. **先骨架后页码**:从设计原则与七大步骤起手定有机骨架,再按 `sw-story-structure` 十一的工作流程换算页码。

## 二、设计原则(designing principle)

- **定义**:能用一句话说清的叙述故事的**整体策略**。"故事设计原则,就是如何将故事前提扩展为深层的结构……它是故事的内在逻辑,将各个部分有机地聚集在一起,让故事的整体格局比各个部分的总和更大。这正是故事的独创性。"(Ch2)
- **与前提的分工**:"所有故事都有故事前提,但只有好的故事有设计原则。故事前提是具体的,是实际发生的;故事设计原则是抽象的,是发生于故事当中更深层的流程……**故事设计原则=故事发展过程+具独创性的手法**。"(Ch2)前提答"发生什么事",设计原则答"用什么形式讲"。
- **三种一层各管一件事,不互相替代**(与 `sw-premise-theme` 的接口):埃格里前提(人物特质+导致+结局)=辩证证明的责任;麦基主控思想(价值+原因)=高潮的意义;特鲁比设计原则=叙述的形式策略。同一项目三者都写,各进 story-bible 一行。
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add jtydhr88/screenwriting-skills/sw-truby-anatomy@sha256:e057bdd7ffc34e07

The line at the top of this page pins the label git:20260914.cab203f, 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_xupidx6e2fpppoj7.svg)](https://markdownregistry.com/a/art_xupidx6e2fpppoj7)

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

Versions

The registry has recorded 1 version of this file, committed on Sep 14, 2026.

versioncommittedcommitsizeaudit
git:20260914.cab203f latest2026-09-14 cab203f 20,735 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 (20735 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_xupidx6e2fpppoj7
GET https://markdownregistry.com/api/v1/resolve?ref=jtydhr88/screenwriting-skills/sw-truby-anatomy
GET https://markdownregistry.com/api/v1/blob/e057bdd7ffc34e070b9ec3906b9563b3a2fac7c421e5d7ca2b600e799b58c102

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-format-adaptation SKILL.md skill
jtydhr88/screenwriting-skills · plugins/screenwriting/skills/sw-format-adaptation/SKILL.md · Screenplay format, page craft, the writing process and adaptation (剧本格式/写作流程/改编) — merged from Wendy Henson (spec…
git:20260912.ffb70c3 · audit A · 1,971 stars

Every file in jtydhr88/screenwriting-skills

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