Agent skill
treatment-writing
Develop narrative synopses that tell the complete story cinematically, serving as sales documents and production blueprints
Install this agent skill to your Project
npx add-skill https://github.com/a5c-ai/babysitter/tree/main/library/specializations/domains/social-sciences-humanities/arts-culture/film-tv-production/skills/treatment-writing
SKILL.md
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
# [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:
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:
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
# [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
- Read it aloud - Treatments must flow well
- Hook every page - Reader should want to turn
- Emotion over plot - We invest in feelings
- Be specific - Details create believability
- End strong - Closing image should resonate
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
gsd-tools
Central utility skill for GSD operations. Provides config parsing, slug generation, timestamps, path operations, and orchestrates calls to other specialized skills. Acts as the unified entry point that the original gsd-tools.cjs provided via its lib/ modules (commands, config, core, init).
model-profile-resolution
Resolve model profile (quality/balanced/budget) at orchestration start and map agents to specific models. Enables cost/quality tradeoffs by selecting appropriate AI models for each agent role.
verification-suite
Plan structure validation, phase completeness checks, reference integrity verification, and artifact existence confirmation. Provides the structured verification layer ensuring GSD artifacts are well-formed and complete.
state-management
STATE.md reading, writing, and field-level updates. Provides cross-session state persistence via .planning/STATE.md with structured fields for current task, completed phases, blockers, decisions, and quick tasks.
git-integration
Git commit patterns, formats, and conventions for GSD methodology. Provides atomic commits per task, structured commit messages, planning file commits, branch management, and milestone tag operations.
frontmatter-parsing
YAML frontmatter parsing and manipulation for .planning/ documents. Provides read, write, update, query, and validation operations on frontmatter blocks in GSD markdown artifacts.
Didn't find tool you were looking for?