treatment-writing
Develop narrative synopses that tell the complete story cinematically, serving as sales documents and production blueprints
Best use case
treatment-writing is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Develop narrative synopses that tell the complete story cinematically, serving as sales documents and production blueprints
Teams using treatment-writing should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/treatment-writing/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How treatment-writing Compares
| Feature / Agent | treatment-writing | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Develop narrative synopses that tell the complete story cinematically, serving as sales documents and production blueprints
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Treatment Writing Skill ## Purpose Write compelling narrative treatments that tell your complete story in prose form. Treatments serve as sales documents (to attract talent and financing) and production blueprints (to communicate the vision). They must be engaging to read while conveying the full scope of the narrative. ## Treatment Structure ### Header Section ```markdown # [TITLE] A [genre] [format] treatment Written by [Author] [Date] | [Draft Version] --- **Logline:** [One-sentence hook] **Tone:** [Tonal description with references] **Theme:** [Core thematic statement] ``` ### Body Structure | Section | Purpose | Length | |---------|---------|--------| | Opening Image | First visual, sets tone | 1 paragraph | | Setup | World, protagonist, status quo | 1-2 pages | | Inciting Incident | Disruption, story kicks off | 1-2 paragraphs | | Act One | Rising action, stakes | 1-2 pages | | Midpoint | Major revelation/shift | 1-2 paragraphs | | Act Two | Complications, escalation | 2-3 pages | | Climax | Final confrontation | 1-2 paragraphs | | Resolution | New equilibrium | 1 paragraph | | Closing Image | Final visual, mirrors opening | 1 paragraph | ## Writing Style ### Do - Present tense, active voice - Third person (usually) - Cinematic language—describe what we SEE and HEAR - Include key dialogue moments (sparingly) - Convey emotional journey - Create visual setpieces - Maintain genre tone throughout - End acts on hooks ### Don't - Use screenplay format - Include camera directions - Over-explain motivation - Include every scene - Use passive voice - Tell instead of show - Break the fourth wall ## Cinematic Writing ### Show, Don't Tell **Bad:** "John is angry about his father's death and wants revenge." **Good:** "John stands before his father's grave, rain streaming down his face. He pulls a photograph from his pocket—his father, smiling, at John's graduation. John's jaw tightens. He crumples the photo in his fist and turns away." ### Visual Setpieces Describe major visual moments that define your film: ```markdown The helicopter chase through the neon-lit canyons of downtown Tokyo, weaving between skyscrapers as searchlights paint the night sky. Sarah clings to the landing strut, wind tearing at her clothes, as below, the city stretches to infinity—a glittering circuit board of lights and shadow. ``` ### Dialogue Snippets Use sparingly for key moments: ```markdown Marcus steps forward, hand outstretched. "We can end this. Together." Elena's eyes harden. "Some things can't be forgiven, Marcus. Some things can only be avenged." ``` ## Length Guidelines | Format | Treatment Length | |--------|-----------------| | Short Film | 2-3 pages | | Feature | 5-15 pages | | TV Pilot | 8-12 pages | | Limited Series | 15-25 pages (all episodes) | | Episode | 3-5 pages | ## Act Structure Templates ### Three-Act (Feature) **ACT ONE (Setup) - 25%** - Opening image - Introduction of protagonist in their world - Inciting incident - Debate/refusal - Crossing the threshold **ACT TWO (Confrontation) - 50%** - "Fun and games" - exploring the premise - B-story development - Midpoint revelation - Rising stakes - All is lost moment - Dark night of the soul **ACT THREE (Resolution) - 25%** - Break into three - Gathering for final push - Climax - Resolution - Closing image ### TV Pilot Structure **TEASER** - The hook that grabs viewers **ACT ONE** - Establish world and characters **ACT TWO** - Inciting incident and complications **ACT THREE** - Escalation and midpoint **ACT FOUR** - Crisis and decision **ACT FIVE** - Climax and cliffhanger ## Output Format ```markdown # [TITLE] A [genre] [format] treatment --- **Logline:** [Hook] **Tone:** [Description with film references] **Theme:** [Thematic statement] --- ## FADE IN: [Opening image and setup] --- ## ACT ONE [Act one narrative] --- ## ACT TWO [Act two narrative, include midpoint] --- ## ACT THREE [Climax and resolution] --- ## FADE OUT. --- **Key Setpieces:** - [Setpiece 1] - [Setpiece 2] - [Setpiece 3] **Character Arcs:** - [Protagonist]: [Starting state] → [Ending state] - [Antagonist]: [Arc description] ``` ## Pro Tips 1. **Read it aloud** - Treatments must flow well 2. **Hook every page** - Reader should want to turn 3. **Emotion over plot** - We invest in feelings 4. **Be specific** - Details create believability 5. **End strong** - Closing image should resonate
Related Skills
tech-writing-lint
Automated technical writing style and quality enforcement. Lint documentation with Vale, check for inclusive language, enforce style guides, and analyze readability metrics.
tech-writing-linter
Lint technical documentation for style, consistency, and readability
academic-writing-publication
Prepare manuscripts following APA, ASA, or discipline-specific guidelines with proper reporting standards and peer review navigation
philosophical-writing-argumentation
Compose clear, rigorous philosophical prose with well-structured arguments, anticipation of objections, and proper scholarly engagement with existing literature
grant-narrative-writing
Compose compelling research narratives for NEH, ACLS, and foundation funding proposals with clear significance statements
learning-objectives-writing
Write measurable, SMART learning objectives using Bloom's Taxonomy cognitive levels aligned with desired outcomes and assessment strategies
interpretive-writing
Create accessible interpretive content for diverse audiences including labels, wall text, catalog essays, educational materials, and digital content
grant-proposal-writing
Develop compelling funding proposals for foundations, government agencies, and corporations including narrative development, budget creation, and compliance documentation
lyric-writing
Write complete song lyrics with structural annotations and production notes optimized for AI music generation platforms like Suno and Udio
scene-writing
Write individual screenplay scenes with proper industry formatting, visual action, and dramatic structure
logline-writing
Craft compelling one-sentence story hooks that capture protagonist, conflict, stakes, and unique appeal for film/TV pitches
academic-writing-assistant
Skill for assisting with academic and scientific writing