claude-screenwriting
e06084/claude-screenwriting
claude-screenwriting is an agent skill project by e06084 on GitHub: Screenwriting knowledge engine: turns Vogler/McKee/Save the Cat into an Obsidian story wiki with 15-beat pacing, three-layer character cards and structural diagnosis. It covers characters, episodes and review, and its README says it works with Claude Code. 9 stars, last updated 2026-10-08, MIT license.
Editor's notes
install.sh copies the 8 skills into ~/.claude/skills; you start Claude Code inside your Obsidian vault and run /screenwriting to initialize. /screenwriting-ingest turns source material into beat, character and meta pages and generates storyline and character-relationship Canvases; /screenwriting-lint scores the story across four dimensions out of 100; /screenwriting-refactor proposes changes as a diff and writes them only after you confirm. It only reads and writes local Markdown with no external services, and its docs center on the 15-beat film structure without covering episodes or paywall points.
- Type
- Screenwriting fundamentals
- Stages
- Characters · Episodes · Review
- Agents
- Claude Code
- Format
- Agent skill
- Language
- Chinese
- GitHub stars
- ★ 9
- Last updated
- 2026-10-08
- License
- MIT
- SKILL.md files
- 8
- Checked by hand
- 2026-10-13
In the author's words
Structured screenwriting skills for Claude Code + Obsidian
Skills in this repo (8)
Names and descriptions come from each SKILL.md frontmatter; Chinese descriptions are shown in our English translation.
- screenwriting-beats
View, edit or AI-generate a Save the Cat 15-beat sheet. When generating, beat content is driven by the genre-engine constraints and the existing character sheet. Triggers on: "/screenwriting-beats", "beat sheet", "beat sheet", "15 beats", "beat table".
- screenwriting-character
View, create or edit character cards. Based on Vogler's 8 archetypes + McKee's contradiction + Save the Cat's four pillars. 3-layer structure: characterization (outer), character truth (inner), character dimensions (structure). Supports adding, removing or editing a single character with fully cascading updates (character relationship canvas + storyline beats). Triggers on: "/screenwriting-character", "character", "characters", "character card", "character card".
- screenwriting-export
Export story material to a specific format. Supports a one-page outline, character list, script skeleton and full package. Triggers on: "/screenwriting-export", "export", "export outline", "export characters".
- screenwriting-ingest
Extracts structured story elements from source files in a 3-stage pipeline (Meta → Characters → Beats), writes them to Obsidian wiki pages and maintains backlinks, and also generates storyline and character-relationship Canvases. Triggers on: "/screenwriting-ingest", "import material", "intake", "ingest".
- screenwriting-lint
Dramatic-structure health check. Scans the wiki vault, diagnoses structural completeness, character-arc consistency and link integrity along screenwriting-theory dimensions, and outputs a scored report with prioritized fix suggestions. Triggers on: "/screenwriting-lint", "diagnose", "check", "health", "story health".
- screenwriting-refactor
Restructures the story under screenwriting-theory constraints. Reads the current wiki, generates a restructuring proposal with a diff, and writes the changes after the user confirms. Supports genre conversion, structural strengthening, character reshaping and more. Triggers on: "/screenwriting-refactor", "refactor", "adjust structure", "restructure".
- screenwriting-reimagine
Creatively reimagines the story from an existing version (adjusting the protagonist, storyline, worldbuilding, etc.), generating a brand-new version in a 3-stage pipeline (Meta → Characters → Beats), with confirmation possible at each stage before moving on; it is saved as a separate version without overwriting the original. Triggers on: "/screenwriting-reimagine", "reimagine", "re-create", "reimagine", "new version", "swap the protagonist", "change the storyline", "adapt".
- screenwriting
AI-powered screenwriting companion based on Vogler, McKee, and Save the Cat. Maintains a structured story wiki in Obsidian. Ingests raw materials into beats and characters. Refactors story structure with theoretical constraints. Diagnoses structural health of screenplays. Triggers on: "/screenwriti…
Install
npx skills add e06084/claude-screenwriting
# install a single skill
npx skills add e06084/claude-screenwriting --skill screenwriting-beats
# pick agents (claude-code / codex / cursor / opencode / gemini-cli / openclaw)
npx skills add e06084/claude-screenwriting -a claude-code -a codexDefault commands use the skills CLI and were not verified one by one; follow the repo README. Read SKILL.md before installing. Install guide →
Similar projects
The most systematic screenwriting-theory set here: structure, Truby, scenes, dialogue, series bible, writers' room, with cases from Japan, Korea, France, the US and Chinese opera
Shanyin Super Screenwriting Master: characters, outline, scene breakdown and full script in four formats: concept micro-film, narrative short, feature and multi-episode series
Kunka Screenwriting Master: Chinese-first screenwriting skill set covering ideation, revision, continuity checks and series development
Narrative Harness: a local state tool for writing Chinese novels and scripts; the older long-form screenplay templates remain in legacy/