screenwriting-skills README

The project's README from github.com/jtydhr88/screenwriting-skills. As one markdown file: README.md.

screenwriting-skills

中文版

13 Claude Code skills for screenwriting and dramaturgy, distilled from 19 books (Chinese, American and Japanese) plus two complete master-work corpora: Chekhov's plays and Ozu Yasujiro's screenplays.

Skill bodies are written in Chinese (the sources and quotations are Chinese translations); frontmatter descriptions are in English with Chinese keywords so both languages trigger them.

Install

/plugin marketplace add jtydhr88/screenwriting-skills
/plugin install screenwriting@screenwriting-skills

Skills

Skill What it covers Main sources
sw-workflow Project orchestrator: stage map (premise → structure → character → scenes → draft → revision → submission) naming which skill to call, per-stage deliverables and advisory exit checks, entry paths (from scratch / existing draft / adaptation / short form / series), and a story-bible.md convention that keeps all project state in one file so work resumes across sessions (meta-skill, no new sources; see issue #1)
sw-story-structure Paradigm & plot points, Save the Cat beats and board, McKee's event/scene/sequence/act, inciting incident, progressive complications, crisis-climax-resolution, subplots, Hoxter's nine beats, Hicks' attraction/anticipation/satisfaction, Lu Jun's 起承转合, eight openings, eight endings Field, Snyder, McKee Story, Hoxter, Hicks, Lu Jun
sw-premise-theme Premise as tyrant, controlling idea (value + cause), the "third rail" (desire vs misbelief), five premise questions, logline tests, 选材/开掘/视角/戏核/冲突要真/情节要奇 Egri, McKee, Cron, Hicks, Hoxter, Snyder, Lu Jun
sw-character-conflict Three-dimensional character, orchestration, unity of opposites, pivotal character, rising vs static vs jumping conflict, transition; Freud/Erikson/Jung/Campbell/Murdock/Adler/May for motive; 人物要活八要, 对手要强, 给对手一把刀 Egri, Indick, McKee, Hicks, Cron, Snyder, Lu Jun
sw-dialogue Dialogue as action, said/unsaid/unsayable, exposition as ammunition, beats as gerunds, credibility/language/content/design flaws, character-specific vocabulary, seven scene analyses; 语言要美 (典雅/通俗, 动作性/性格化/潜台词, 戏曲唱词三好) McKee Dialogue, Walter, Hicks, Lu Jun, Egri, Snyder, Mei Feng
sw-scene-craft Scene as value turn, five-step scene analysis, enter late leave early, pacing and transitions, action over talk, alternative locations; 意趣要足 (suspense, delay, wit), 细节要妙, 道具要精, 场景要当 McKee, Field, Hicks, Walter, Henson, Hoxter, Mei Feng, Lu Jun
sw-format-adaptation Spec format hard rules, exact typographic grid, element conventions (V.O./O.S., MORE/CONT'D, dual dialogue, montage), Fountain output contract with forced markers for Chinese and PDF/.fdx render paths, Chinese 场号制 and Japanese 柱・ト書き formats, action-paragraph craft, drafts and outlines (step outline → treatment → script), revision, adaptation principles Henson, Walter, Hicks, Field, McKee, Hoxter, Diamond & Weissman, Bork; typographic grid, Fountain and Asian formats are industry conventions (issue #2), not from the books
sw-american-case-studies Worked examples: Westerns, screwball, Wilder, Hitchcock, Adaptation, Mildred Pierce, Thelma & Louise, Fargo, Good Will Hunting, American Beauty, Eternal Sunshine, American Graffiti, Bourne, Guardians, Zootopia, Thor Mei Feng, Walter, masterclass, Hoxter, Snyder, Field
sw-japanese-screenwriting Ten Japanese directors/writers: structure-first vs fragment-first methods, small-material notebooks, "if + moreover", character = actor + flaw, tsukkomi systems, theme-emerges-later, originals born from constraints; Arai Haruhiko 泊贵洋 ed., masterclass (international)
sw-korean-french-screenwriting Korean and French methods from the international masterclass: Oh Seung-uk (write the emotion, research before writing, structure as space, find your own angle), Choi Seok-hwan (genre as a promise, make the audience wait, two reversals, desire and crisis), Obitan (French system, write dialogue last, viewpoint and hidden motive, writer on set, collective writing) masterclass (international)
sw-industry-business Buyer's-eye workflow, PROBLEM idea test, logline/query/pitch, agents, options, credits, WGA, gross vs net, notes and rewrites, film vs TV, Oscar logic, career resilience Diamond & Weissman, Bork, Hicks, Walter, Henson, Snyder, Hoxter, Mei Feng, masterclass
chekhov-dramaturgy Chekhov's seven full-length plays and one-acts as a working method: structure, character, dialogue, sound and stage directions, revision (Wood Demon → Uncle Vanya), with act-by-act tables and excerpts 契诃夫戏剧全集 (焦菊隐/童道明/李健吾译)
ozu-screenplay-style Ozu Yasujiro's six screenplays as a working method: shared skeleton, marriage-of-a-daughter structure, dialogue register, format, theme sentences, with scene tables and excerpts 小津安二郎剧本集

Each skill has a SKILL.md (principles, checklists, workflow) and most have a reference.md (tables, worked analyses, excerpts).

Source books (19)

Conventions

Sister project, same idea applied to Japanese composition and arranging: japanese-composition-skills.

screenwriting-skills (jtydhr88/screenwriting-skills)

Searching Database…

Что это?Коллекция из 13 навыков Claude Code, обучающих ИИ-агента ремеслу киносценария, телесценариев и драматургии, извлечённая из 19 китайских, американских и японских книг о сценарном мастерстве, а также из полного собрания произведений Чехова и Одзу Ясудзиро.
Это пакет навыков Claude Code, а не самостоятельное приложение для письма?Да — каждая из 13 тем это папка со SKILL.md (принципы, чек-листы, рабочий процесс) и обычно reference.md (таблицы, выдержки); запускать самому ничего не нужно, Claude Code загружает их, чтобы вести собственный процесс письма.
Как начать пользоваться этими навыками?В репозитории команды установки не расписаны, есть только заголовок Install; судя по заявленным соглашениям, Claude Code сканирует именно фронтматтер SKILL.md каждой папки навыка (имя в kebab-case, совпадающее с папкой), так что положите папки навыков туда, где ваша настройка Claude Code ищет навыки, и доверьте sw-workflow координацию остального.
Нужен ли Claude Code, чтобы пользоваться этими навыками?Да — это навыки, написанные для Claude Code, а не самостоятельная программа; без агентской среды, читающей файлы SKILL.md, китайскоязычный markdown остаётся просто справочными заметками.
Смогу ли я читать содержимое навыков без знания китайского?Только описания во фронтматтере SKILL.md на английском; сами принципы, чек-листы, таблицы и цитируемые выдержки внутри каждого навыка написаны по-китайски, ведь 19 исходных книг и корпусы Чехова/Одзу — это китайские переводы.
Что необычного в здешней лицензии?Хотя на GitHub указан MIT, сам README говорит, что лицензия дана только для личного изучения, а цитаты остаются собственностью исходных авторов и переводчиков — так что извлечённое книжное содержание не обязательно покрыто стандартным разрешением MIT.
Как организованы 13 навыков?sw-workflow координирует остальные, которые покрывают структуру истории, завязку/тему, персонажа/конфликт, диалоги, мастерство сцены, формат/адаптацию, американские и японские/корейские/французские кейсы, индустрию/бизнес, плюс два отдельных навыка, построенных на пьесах Чехова и сценариях Одзу.
Могут ли эти навыки выдать файл сценария по индустриальному стандарту?sw-format-adaptation определяет контракт вывода Fountain с принудительными маркерами для китайского текста, плюс пути рендера PDF/.fdx, а также точную типографскую сетку spec-формата и соглашения об элементах вроде V.O./O.S. и двойных диалогов.
Почему Чехов и Одзу выделены отдельно от навыков из книг о мастерстве?chekhov-dramaturgy и ozu-screenplay-style извлечены из полных корпусов главных работ (семи больших пьес Чехова и шести сценариев Одзу), а не из теоретических книг, и дают таблицы по актам и выдержки как рабочий метод, взятый прямо из самих произведений.
Есть ли родственный проект для творческой работы вне сценарного ремесла?Автор упоминает проект-сателлит japanese-composition-skills, который применяет тот же подход извлечения из книг к японской музыкальной композиции и аранжировке.
Creator
jtydhr88
Size
2.1 MB
Stars
1.7K
Updated
CommitOct 03
Age
1mo
Commits · 90 Days