Scriptwriter Skill
Provides professional knowledge for Scriptwriters to create high-quality, structured scripts, supporting series continuity and sequel creation based on previous works.
Overview
This skill supports the creation of:
- Fully structured scripts - Three-act structure with 9+ key narrative moments
- Continuity-focused series episodes - Maintain consistency in characters, settings, and style
- Visualized scenes - Detailed descriptions that facilitate storyboard conversion
Core Principles
1. Visual Priority
Scripts must be easy to convert into storyboards. Avoid abstract psychological descriptions; use specific visual descriptions.
❌ Abstract: Emma feels confused and scared.
✅ Visual: Emma's eyes widen, her fingers trembling as she flips through the pages. Sweat beads slide down her forehead.
2. Character Consistency
- Establish standardized appearance descriptions (for first appearances)
- Maintain consistent key identifiers in subsequent episodes
- Ensure logical and gradual character development
3. Clear Structure
Three-act structure:
- Act 1 (~25%): Setup - Establish the world and inciting incident
- Act 2 (~50%): Confrontation - Rising action, midpoint twist, low point
- Act 3 (~25%): Resolution - Climax, resolution, new equilibrium
4. Sufficient Beats
Ensure the script contains at least 9 clear visual turning points, distributed across the three acts.
Quick Start
Process for Creating a New Episode
Step 1: Review Series History
bash
# View existing episodes
ls script/
# Read previous works to understand character and plot development
Step 2: Develop the Story Based on User Input
Users may provide:
- Theme keywords (e.g., "betrayal", "uncovering the truth")
- Plot directions (e.g., "Character A discovers a secret")
- Emotional tones (e.g., "suspenseful", "warm and heartfelt")
Step 3: Plan the Structure
- Continue the worldview and character states from previous works
- Design 9+ key narrative moments
- Arrange the three-act structure
Step 4: Write the Script
Use standard scene formatting, ensuring:
- Scene heading:
## Scene {X} - {INT./EXT.} {Location} - {Time}
- Complete appearance descriptions for characters making their first appearance
- Actions are written in present tense and visualized
- Sufficient beat candidates (≥9)
Step 5: Output
File naming: script/ep{XX}-{title}.md
Example: script/ep03-betrayal.md
Series Continuity Checklist
Before creating a new episode:
Output Constraints
Strictly prohibited:
- ❌ Frontmatter metadata
- ❌ Template instructions
- ❌ Overly abstract psychological descriptions
- ❌ Scenes lacking visual details
Must include:
- ✅ Scene number, location, and time
- ✅ Appearance descriptions for first-appearing characters
- ✅ Visualized scenes and actions
- ✅ Sufficient key moments (≥9 beat candidates)
- ✅ Complete three-act structure
Detailed Resources
Methodology Guides 📖
- screenplay-methodology.md - Screenplay creation methodology
- Three-act structure and story arcs
- Character development principles
- Scene construction techniques
- Visual description methods
- Series continuity management
Writing Guidelines 📖
- GUIDELINES.md - Detailed writing specifications
- Scene formatting standards (scene headings, time markers)
- Rules for character first appearances
- Best practices for action descriptions
- Beat distribution guidelines (allocation of 9 beats across three acts)
- Dialogue writing techniques
- Output checklist
Templates
- templates/episode-template.md - Standard episode script format
- templates/series-continuity-guide.md - Series continuity checklist
When to Use
Auto-trigger scenarios:
- User requests "create a new episode"
- User provides a story concept that needs to be converted into a script
- Need to prepare materials for Storyboard Artist
Manual reference scenarios:
- Unsure about scene formatting
- Handling series continuity issues
- Planning beat distribution
- Resolving character consistency issues
Example Scene Format
markdown
## Scene 5 - INT. SUBWAY CAR - NIGHT
The car is dim, with flickering white fluorescent lights. A few discarded newspapers are scattered on the empty seats.
EMMA (25, silver long hair, wearing a deep red coat) sits by the window, flipping open an old leather notebook.
Dense handwritten symbols and glowing hexagram patterns are reflected on her face.
Suddenly, all the lights go out.
Usage: Automatically referenced by the Scriptwriter agent. Methodology and guidelines (marked 📖) use progressive disclosure and are only consulted when needed.