mcpField
F
film-script-generator

film-script-generator

github.com/changhochienCreative & media070 installsUpdated 31w ago
Repository

About film-script-generator

A creative-writing skill for generating screenplays, scenes, dialogue, and story beat sheets for film and video production. It provides screenplay-format guidance and character and story-structure references.

Key features

  1. 01Generate full scripts and individual scenes
  2. 02Write dialogue for specified characters
  3. 03Create story beat sheets
  4. 04Format screenplay scene headings and action
  5. 05Use character and scene templates

Use cases

  1. 01Draft a screenplay from a logline
  2. 02Write a tense standalone scene
  3. 03Develop dialogue for a set of characters
  4. 04Outline a story with a beat sheet

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/changhochien/film-production-team-skills --skill film-script-generator

After installing, type/film-script-generatorin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/
dialogue-techniques.md
screenplay-format.md
templates/
character-template.md
scene-template.md

Details

From the project README

Film Script Generator Skill v2.0

Act as an AI screenplay writer. Generate scripts, scenes, and dialogue for film and video production.

Quick Reference

CommandPurpose
/script [logline]Generate full script
/scene [description]Generate single scene
/dialogue [characters]Write dialogue
/beat [moment]Story beat sheet

Script Formats

Scene Heading (Slug Line)
INT. COFFEE SHOP - DAY
EXT. CITY STREET - NIGHT
Action Lines
Sarah enters the coffee shop, scanning the room. She spots John in the corner and walks toward him.
Character Cue & Dialogue
                         SARAH
              (nervous)
        I've been waiting for you.

                         JOHN
        I know. I'm sorry.
Parenthetical
                         SARAH
        (whispering)
        Don't say anything.
Transition
                                    CUT TO:

                         DISSOLVE TO:

Story Structure

Three Act Structure
ACT I (Pages 1-25): Setup
- Opening image
- Theme stated
- Setup
- Catalyst
- Debate

ACT II (Pages 25-75): Confrontation
- B story
- Fun and games
- Midpoint
- Bad guys close in
- All is lost
- Dark night of the soul

ACT III (Pages 75-110): Resolution
- Finale
- Final image
Save the Cat Beat Sheet
  1. Opening Image (p.1)
  2. Theme Stated (p.5)
  3. Set-Up (p.1-10)
  4. Catalyst (p.12)
  5. Debate (p.12-25)
  6. Break into Two (p.25)
  7. B Story (p.30)
  8. Fun and Games (p.30-55)
  9. Midpoint (p.55)
  10. Bad Guys Close In (p.55-75)
  11. All Is Lost (p.75)
  12. Dark Night of Soul (p.75-80)
  13. Break into Three (p.80)
  14. Finale (p.80-110)
  15. Final Image (p.110)

Character Development

Character Sheet
NAME: [Character name]
AGE: [Age]
OCCUPATION: [Job]
APPEARANCE: [Description]
PERSONALITY: [Traits]
GOAL: [What they want]
WORLDVIEW: [Beliefs]
DEFECT: [Flaw]
CONFLICT: [What opposes them]

Dialogue Principles

  1. Subtext - Characters don't say exactly what they mean
  2. Voice - Each character has distinct speech patterns
  3. Economy - No wasted words
  4. Conflict - Dialogue is negotiation/combat
  5. Authenticity - Sounds like real speech (but better)

Generating Content

For full screenplay format:

  • Read: references/screenplay-format.md

For dialogue techniques:

  • Read: references/dialogue-techniques.md

For templates:

  • Read: templates/scene-template.md
  • Read: templates/character-template.md

Integration

Scripts generated feed into:

  • film-director - For blocking and shot design
  • film-dp - For visual style
  • film-editor - For post-production

Quick Scene Generation

/scene: INT. ABANDONED WAREHOUSE - NIGHT
Two rival gang leaders meet for a tense negotiation.
Sarah represents the North Side crew. Marcus leads
the Downtown faction. The meeting goes bad.

Generate 2-3 pages of tension with dialogue,
action lines, and proper scene formatting.

Comments

Markdown supported