Skip to main content
Film & TelevisionScreenplay Audit147 lines

Slugline and Format Fixer

Automated detection and correction of screenplay formatting errors. Fixes malformed sluglines, character cue capitalization, parenthetical overuse, transition formatting, scene numbering, and page break issues. Includes the complete formatting reference for all 11 screenplay formats.

Quick Summary25 lines
Scans a screenplay for formatting violations and produces corrected output. Every fix is cited
with the original line, the corrected line, and the rule that applies.

## Key Points

1. **Prefix**: Must be one of: `INT.`, `EXT.`, `INT./EXT.`, `EXT./INT.`, `I/E.`
2. **Location**: ALL CAPS, specific and concise (e.g., `SARAH'S APARTMENT - KITCHEN`)
3. **Separator**: Single dash surrounded by spaces (` - `)
4. **Time of day**: `DAY`, `NIGHT`, `DAWN`, `DUSK`, `CONTINUOUS`, `LATER`, `SAME TIME`, `MOMENTS LATER`
- **Spec script**: No scene numbers. Remove any present.
- **Shooting script**: Sequential, no gaps, no duplicates. Format: `1.` at left margin, matching number at right margin of same slugline.
- Character cue must not appear at bottom of page without at least one line of dialogue on same page
- `(MORE)` at bottom and `(CONT'D)` at top when dialogue splits across pages
- Sluglines should not appear as the last line on a page
- `(CONTINUED)` at page top/bottom is optional in modern specs — if present, must be consistent
- **Do not guess time of day.** If a slugline is missing time of day and context does not make it
- **Do not change creative intent.** If a slugline uses `CONTINUOUS` or `MOMENTS LATER`, preserve

## Quick Example

```
INT./EXT. LOCATION - TIME OF DAY
```
skilldb get screenplay-audit-skills/slugline-and-format-fixerFull skill: 147 lines
Paste into your CLAUDE.md or agent config

Slugline and Format Fixer

Scans a screenplay for formatting violations and produces corrected output. Every fix is cited with the original line, the corrected line, and the rule that applies.

When to Use

Use when the user asks to "fix formatting", "clean up sluglines", "fix scene headings", "correct my screenplay format", "fix character cues", or provides a script with visible formatting errors. Also use as the first pass before any content-level audit — formatting errors must be resolved before structural analysis is meaningful.

Slugline Rules

A properly formatted slugline (scene heading) follows this pattern:

INT./EXT. LOCATION - TIME OF DAY

Required Components

  1. Prefix: Must be one of: INT., EXT., INT./EXT., EXT./INT., I/E.
  2. Location: ALL CAPS, specific and concise (e.g., SARAH'S APARTMENT - KITCHEN)
  3. Separator: Single dash surrounded by spaces (-)
  4. Time of day: DAY, NIGHT, DAWN, DUSK, CONTINUOUS, LATER, SAME TIME, MOMENTS LATER

Common AI Errors in Sluglines

ErrorExampleFix
Missing prefixThe apartment - DayINT. APARTMENT - DAY
Sentence caseInt. Living Room - NightINT. LIVING ROOM - NIGHT
Missing time of dayINT. WAREHOUSEINT. WAREHOUSE - DAY (flag for user)
Narrative sluglineInside the dark warehouse at nightINT. WAREHOUSE - NIGHT
Wrong separatorINT. OFFICE -- NIGHT or INT. OFFICE, NIGHTINT. OFFICE - NIGHT
Parenthetical timeEXT. PARK (SUNSET)EXT. PARK - DUSK
Embedded actionINT. CAR - DAY - RAIN POURS DOWNSplit: slugline + action line
Double location without slashINT. AND EXT. HOUSE - DAYINT./EXT. HOUSE - DAY

Character Cue Rules

Character names appearing above dialogue must be ALL CAPS, centered, and consistent throughout.

Fixes

ErrorExampleFix
Lowercase cueSarahSARAH
Inconsistent namingDETECTIVE MARSH then DET. MARSHStandardize to one form
Missing extensionSARAH speaking off-screenSARAH (O.S.) or SARAH (V.O.)
Extension spacingSARAH(V.O.)SARAH (V.O.)
Extension punctuationSARAH (VO)SARAH (V.O.)

Parenthetical Rules

Parentheticals appear on their own line between the character cue and dialogue, in lowercase, enclosed in parentheses.

Fixes

ErrorExampleFix
Too long (>1 line)(turning slowly to face her while reaching for the gun on the table)Move to action line
Directing emotion(feeling betrayed and angry)Cut or rewrite as action
Used as action(she crosses to the window)Move to action line
Overuse (>30% of cues)Parenthetical on every lineFlag; suggest removal of weakest
Capitalized(Whispering)(whispering)

Transition Rules

Transitions (CUT TO:, FADE TO:, SMASH CUT TO:, MATCH CUT TO:) are right-aligned and followed by a colon.

Fixes

ErrorExampleFix
Missing colonCUT TOCUT TO:
Left-alignedLeft-justified FADE TO:Right-align
OveruseTransitions between every sceneRemove all except intentional ones
Non-standardSCENE CHANGE TO:Remove or replace with standard
In spec scriptExcessive use in specKeep only act breaks and dramatic beats

Scene Numbering Rules

Scene numbers appear only in shooting scripts, not in spec scripts.

  • Spec script: No scene numbers. Remove any present.
  • Shooting script: Sequential, no gaps, no duplicates. Format: 1. at left margin, matching number at right margin of same slugline.

Fixes

ErrorExampleFix
Numbers in spec1. INT. OFFICE - DAYINT. OFFICE - DAY
Gaps in shootingScenes 1, 2, 5, 6Flag missing 3, 4
DuplicatesTwo Scene 7sFlag for resolution
Inconsistent formatMix of 1., #1, Scene 1Standardize

Page Break Rules

  • Character cue must not appear at bottom of page without at least one line of dialogue on same page
  • (MORE) at bottom and (CONT'D) at top when dialogue splits across pages
  • Sluglines should not appear as the last line on a page
  • (CONTINUED) at page top/bottom is optional in modern specs — if present, must be consistent

Format-Specific Overrides

FormatSpecial Rules
Feature (FEAT)Standard rules apply
TV Drama (LIMITED, SERIES)Act breaks labeled: END OF ACT ONE, ACT TWO etc.
TV ComedyAct/scene labels; may use COLD OPEN
Adult Animation (ANIM-A)May include ANIMATIC NOTE: blocks
Kids Animation (ANIM-K)Act breaks for 11-min (2-act) vs 22-min (3-act)
Documentary (DOC)NARRATION (V.O.) blocks; INTERVIEW: setups; B-ROLL: cues
Short Film (SHORT)Standard; no act break labels unless user specifies
Web Series (WEB)Cold open standard; act labels optional
Stop-Motion (STOP)Standard plus physical staging notes
CG (CG)Standard plus VFX notation conventions
Animated Film (ANIM-F)Standard plus visual gag staging

Output Format

Present fixes in a table per category (Sluglines, Character Cues, Parentheticals, Transitions, Scene Numbers, Page Breaks) with columns: Scene | Original | Corrected | Rule. Include a summary count of fixes applied and warnings requiring manual review.

Anti-Patterns

  • Do not guess time of day. If a slugline is missing time of day and context does not make it obvious, flag it for the user rather than inventing one.
  • Do not change creative intent. If a slugline uses CONTINUOUS or MOMENTS LATER, preserve it. Only fix formatting, not narrative pacing.
  • Do not reformat shooting scripts as specs. If the user provides a shooting script, scene numbers and camera directions are correct. Ask if unclear.

Install this skill directly: skilldb add screenplay-audit-skills

Get CLI access →

Related Skills

tone-consistency-auditor

Screenplay tone consistency auditor — detects tonal drift, genre confusion, and register inconsistency across a screenplay. Scans for: comedy/drama whiplash, AI defaulting to prestige drama regardless of genre, scenes that belong in a different movie, tonal register shifts between sessions, horror that's not scary, comedy that's not funny, and the AI tendency to flatten everything to "serious with moments of levity." Produces a tonal map and identifies scenes that break the tonal contract. Use when the screenplay feels tonally uneven or like it can't decide what kind of movie it is.

Screenplay Audit243L

visual-storytelling-auditor

Detects the #1 AI screenplay failure: writing for the page instead of the screen. Scans for talking-head scenes with no visual action, missed opportunities for visual storytelling, scenes that could be silent but aren't, over-reliance on dialogue to convey information/emotion that should be shown, static staging (characters sitting and talking), no use of props/environment/weather/lighting as storytelling tools, and action lines that describe internal states instead of visible behavior. Produces a visual storytelling score and specific cinematic rewrite suggestions. Use when the screenplay reads like a stage play or radio drama rather than a film.

Screenplay Audit247L

V.O. and O.S. Fixer

Specialized tool for fixing V.O. (voice-over) and O.S. (off-screen) attribution in screenplays. AI consistently confuses these extensions. Also covers CONT'D usage, PRE-LAP, and other dialogue extensions with clear rules and correction examples.

Screenplay Audit120L

Act Structure Mapper

Deep structural analysis for screenplays in any format. Maps the script's actual act breaks, inciting incident, midpoint, dark moment, climax, and resolution against ideal structural targets. Produces a visual page-map comparing actual vs expected beat placement.

Screenplay Audit163L

ai-dialogue-detector

Detects AI-generated dialogue patterns specific to screenplays: on-the-nose dialogue where characters say exactly what they feel, exposition dumps disguised as conversation, every character being equally articulate, missing subtext, dialogue that reads as written rather than spoken, therapy-speak, characters narrating the plot to each other, and the AI tendency to resolve conflict through a single perfect speech. Produces a per-scene dialogue quality score with specific rewrite direction. Use when screenplay dialogue feels flat, over-written, or like characters are reading essays to each other.

Screenplay Audit272L

Animation Script Checker

Format-specific checker for animated screenplays across kids, adult, film, stop-motion, and CG formats. Verifies visual stageability, voice performance dialogue, gag specificity, age-appropriate content, and correct act structure for episode length.

Screenplay Audit168L