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

# AI-assisted script writing and scene import in CineFlow

> Polish your screenplay, continue writing, generate shot suggestions from your script, and create storyboard images from the Script workspace.

The Script workspace includes a set of AI tools that work directly on your screenplay content. You can ask the AI to improve an existing draft, continue writing from where you left off, extract scenes and shots from a script, or generate storyboard images for individual shots, all from the toolbar inside the Script workspace.

## AI actions in the Script workspace

| Action              | What it does                                                                               |
| ------------------- | ------------------------------------------------------------------------------------------ |
| **Polish**          | Improves dialogue, action lines, pacing, and clarity while preserving your original intent |
| **Continue**        | Writes new screenplay pages that continue from the end of your current script              |
| **Generate shots**  | Reads a scene and suggests individual shot setups (shot type, angle, lens, movement)       |
| **Generate scenes** | Reads your script or a description and suggests a scene breakdown                          |

## Polishing your script

<Steps>
  <Step title="Open the Script workspace">
    Open a project and navigate to the **Script** tab.
  </Step>

  <Step title="Trigger Polish from the toolbar">
    Select **Polish** from the AI actions menu. CineFlow sends your current script content to the AI.
  </Step>

  <Step title="Review the result">
    The polished version streams back into the editor. Check the changes and edit anything you want to adjust further.
  </Step>
</Steps>

<Note>
  Polish preserves your scene headings, character names, and story structure. It focuses on line-level improvements, tightening action blocks, improving dialogue rhythm, and removing redundant description.
</Note>

## Continuing your script

<Steps>
  <Step title="Choose Continue from the AI toolbar">
    Select **Continue** and specify how many pages you'd like the AI to write. One screenplay page is roughly 250 words.
  </Step>

  <Step title="Let the AI write">
    New content streams in after your existing script. The AI matches your tone, style, and established characters, and leaves the narrative open for further continuation.
  </Step>

  <Step title="Edit and integrate">
    Review the generated pages and integrate them into your draft. The AI output follows Fountain formatting conventions, so scene headings, character names, and dialogue will parse correctly.
  </Step>
</Steps>

<Tip>
  For best results when using **Continue**, write at least two or three scenes first. The more material the AI has to go on, the better it matches your voice.
</Tip>

## Smart scene import (AI reads your script)

Smart scene import lets CineFlow read your script content and create scene and shot entries in your shot list automatically.

<Steps>
  <Step title="Use Generate scenes from the toolbar">
    Select **Generate scenes** from the AI toolbar. CineFlow analyses your script and returns a list of suggested scenes with setting (INT/EXT) and time of day.
  </Step>

  <Step title="Review the suggested scenes">
    The AI returns a structured list. Review it and confirm which scenes to add to your shot list.
  </Step>

  <Step title="Generate shots for each scene">
    With a scene selected, use **Generate shots**. CineFlow reads the scene heading, setting, and any script content you provide, then suggests individual shot setups with shot number, description, type, angle, lens, and movement.
  </Step>

  <Step title="Add shots to your shot list">
    Confirm the suggestions you want to keep. They're added to your shot list under the correct scene.
  </Step>
</Steps>

Shot suggestions use standard production values:

* **Shot types**: Wide, Medium, Close-Up, Extreme Close-Up, Over-the-Shoulder, POV, Insert, Two-Shot, Establishing
* **Angles**: Eye Level, Low Angle, High Angle, Dutch, Bird's Eye, Worm's Eye
* **Movement**: Static, Pan, Tilt, Dolly, Tracking, Crane, Handheld, Steadicam
* **Lenses**: 14mm through 200mm

## Storyboard generation

For any shot in your shot list, you can generate a storyboard image from the shot description.

<Steps>
  <Step title="Open a shot in the shot list">
    Go to your shot list and open the shot you want to storyboard.
  </Step>

  <Step title="Trigger storyboard generation">
    Click the storyboard generation button on the shot. CineFlow uses your shot description as the prompt.
  </Step>

  <Step title="Review the image">
    The AI generates a cinematic storyboard frame, clean black-and-white sketch, 16:9 aspect ratio, film production style. The image is saved to the shot automatically.
  </Step>
</Steps>

<Warning>
  Storyboard images are generated from your shot description text. A vague description like "wide shot of location" produces a generic result. Write specific descriptions, camera placement, action happening in frame, key subjects, for more accurate frames.
</Warning>

## Tips for getting good results

<AccordionGroup>
  <Accordion title="Format your script with proper Fountain conventions">
    The AI generates and reads scripts in Fountain format. Scene headings must start with `INT.` or `EXT.`, character names must be in ALL CAPS on their own line, and dialogue follows immediately after. Proper formatting ensures the parser handles generated content correctly.
  </Accordion>

  <Accordion title="Give Generate shots enough context">
    If you're generating shots for a heavy action scene, paste or type a brief description of what happens, even a sentence, into the scene content field. The AI uses this alongside the scene heading and setting to produce more relevant shot suggestions.
  </Accordion>

  <Accordion title="Use Polish before exporting">
    Run **Polish** as a final pass before exporting to PDF. It catches inconsistent formatting, cleans up action line rhythm, and tightens dialogue without changing your story.
  </Accordion>

  <Accordion title="Continue in short increments">
    Requesting one or two pages at a time gives you more control over where the story goes than requesting five or more pages in a single pass. You can always run **Continue** again.
  </Accordion>
</AccordionGroup>

## Powered by AI

The Script AI runs on Anthropic Claude and is built into your CineFlow subscription. Storyboard generation uses a separate AI image model. You don't need to configure API keys or enable anything, these features are available in the Script workspace by default.