> ## Documentation Index
> Fetch the complete documentation index at: https://docs.videodraft.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Screenplay & Script Writing

> Write professional scripts with AI assistance

## Overview

The Script Editor supports multiple screenplay formats and integrates with the AI Screenwriter agent for generation and refinement.

## Supported Formats

### Screenplay Format

Traditional film/TV script format with:

* Scene headings (INT./EXT.)
* Action descriptions
* Character names
* Dialogue
* Parentheticals
* Transitions (FADE OUT, CUT TO, DISSOLVE TO, SMASH CUT)

```
INT. COFFEE SHOP - DAY

SARAH (30s, determined) sits alone at a corner table,
laptop open, coffee untouched.

                    SARAH
          (muttering)
     This has to work.

She types furiously. The screen reflects in her eyes.

                                        CUT TO:
```

### Commercial/AV Format

For advertisements and branded content:

* VISUAL
* AUDIO
* VOICEOVER
* SFX/MUSIC
* TEXT ON SCREEN
* END CARD

```
VISUAL: Product hero shot on white background
AUDIO: Upbeat electronic music
VOICEOVER: "Introducing the future of productivity..."
TEXT ON SCREEN: "Now Available"
```

### Documentary/Educational

For informational content:

* Narrator sections
* Interview cues
* B-roll descriptions
* Graphics callouts
* Tutorial steps

### Social Media

For short-form content:

* Hook (first 3 seconds)
* Tips/points
* Demo sequences
* Call-to-action

## Script Elements

The editor recognizes and color-codes:

| Element       | Description                   |
| ------------- | ----------------------------- |
| Scene Heading | Location and time (INT./EXT.) |
| Action        | Visual descriptions           |
| Character     | Speaker name                  |
| Dialogue      | Spoken lines                  |
| Parenthetical | Acting direction              |
| Transition    | Scene changes                 |
| Shot          | Camera direction              |

## AI Screenwriter

The Screenwriter agent helps with:

* Generate - Create scripts from concepts
* Expand - Add detail to outlines
* Rewrite - Improve dialogue and action
* Format - Convert to proper screenplay format
* Analyze - Check pacing and structure

### How to Use

1. Open Script Editor in your project
2. Click "Consult AI Film Crew"
3. Select Screenwriter agent
4. Describe what you need
5. Review and edit the output

## Script Statistics

The editor tracks:

* Page count
* Scene count
* Character list
* Estimated reading time

## Best Practices

Keep scenes visual

* Describe what we see, not what characters think
* Action lines should be filmable

Write for pacing

* Short sentences = faster pace
* White space = breathing room
* Balance dialogue and action

Be specific

* "A red 1967 Mustang" not "a car"
* "Rain hammers the window" not "it's raining"

## Integration

Scripts flow into the storyboard phase where each scene becomes visual frames. The AI Creative Director uses your script to plan shot compositions.

## Next Steps

<CardGroup cols={2}>
  <Card title="Storyboard" icon="table-cells" href="/concepts/storyboard">
    Turn script into visuals
  </Card>

  <Card title="Production Pipeline" icon="diagram-project" href="/concepts/production-pipeline">
    Full workflow overview
  </Card>
</CardGroup>