SuperAPI AI Directory

scriptwriter-skill

Writing & research

View repository

Updated 10-15 21:39

About this skill

Scriptwriter Skill

Provide Scriptwriter with professional expertise in creating high-quality, structured scripts, supporting series continuity and sequel creation based on previous works.

Overview

This skill supports the creation of:

  • Structurally complete scripts - Three-act structure, containing 9+ key narrative moments
  • Series continuity episodes - Maintain consistency of characters, setting, and style
  • Visualized scenes - Detailed descriptions that facilitate storyboard conversion

Core Principles

1. Visual First

Scripts must facilitate storyboard conversion. Avoid abstract psychological description; use concrete visual description.

❌ Abstract: Emma feels confused and afraid. ✅ Visualized: Emma's eyes widen, her fingers trembling as she turns the pages. Beads of sweat slide down her forehead.

2. Character Consistency

  • Establish standardized appearance descriptions (first appearance)
  • Keep key identifiers consistent in subsequent episodes
  • Personality development is reasonable and gradual

3. Clear Structure

Three-act structure:

  • Act One (~25%): Setup - establish the world, inciting incident
  • Act Two (~50%): Confrontation - rising action, midpoint turn, low point
  • Act Three (~25%): Resolution - climax, resolution, new equilibrium

4. Sufficient Beats

Ensure the script containsat least 9clear visual turning points, distributed across the three acts.

Quick Start

Process for creating a new episode

Step 1: Review series history

# 查看已有剧集
ls script/

# 阅读前作了解角色和情节发展

Step 2: Envision the story based on user input

The user may provide:

  • Theme keywords (such as "betrayal", "discovering the truth")
  • Plot direction (such as "Character A discovers a secret")
  • Emotional tone (such as "suspense", "warm")

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: Create the script

Use standard scene format, ensuring:

  • Scene heading: ## 场景 {X} - {INT./EXT.} {地点} - {时间}
  • Characters appearing for the first time have complete appearance descriptions
  • Action uses present tense and is visualized
  • Enough beat candidates (≥9)

Step 5: Output

文件命名: script/ep{XX}-{title}.md
示例: script/ep03-betrayal.md

Series continuity checklist

Before creating a new episode:

  • All previous episodes have been read
  • Character appearance descriptions are consistent with previous works
  • Character relationship states match the ending of previous works
  • Unresolved plotlines are considered or advanced
  • No contradictions in worldview setting
  • Visual style and atmosphere remain consistent

Output Constraints

Strictly prohibited:

  • ❌ Frontmatter metadata
  • ❌ Template explanations
  • ❌ Overly abstract psychological description
  • ❌ Scenes lacking visual details

Must include:

  • ✅ Scene number, location, time
  • ✅ Appearance descriptions of characters appearing for the first time
  • ✅ Visualized scenes and actions
  • ✅ Enough key moments (≥9 beat candidates)
  • ✅ Complete three-act structure

Detailed Resources

Methodology Guide 📖

  • screenplay-methodology.md - Screenwriting Methodology
    • Three-Act Structure and Story Arc
    • Character Development Principles
    • Scene Construction Techniques
    • Visual Description Methods
    • Series Continuity Management

Writing Guide 📖

  • GUIDELINES.md - Detailed Writing Standards
    • Scene Format Standards (Scene Heading, Time Notation)
    • Rules for a Character's First Appearance
    • Action Description Best Practices
    • Beats Distribution Guide (Distribution of 9 Beats Across Three Acts)
    • Dialogue Writing Techniques
    • Output Checklist

Template

When to Use

Automatic Trigger Scenarios:

  • User requests "create a new episode"
  • User provides a story concept that needs to be converted into a script
  • Need to prepare material for the Storyboard Artist

Manual Reference Scenarios:

  • Uncertain about scene format
  • Handling series continuity issues
  • Planning beats distribution
  • Resolving character consistency issues

Example Scene Format

## 场景 5 - INT. 地铁车厢内 - 夜晚

车厢内昏暗,白色荧光灯忽明忽暗。空荡的座椅上散落着几张废弃报纸。

EMMA(25 岁,银色长发,穿深红色大衣)坐在靠窗位置,翻开古旧的皮质笔记本。
里面密密麻麻的手写符号和发光的六芒星图案映照在她脸上。

突然,所有灯光熄灭。

Usage: The Scriptwriter agent automatically references this skill. Methodology and guides (marked 📖) use progressive disclosure and are consulted only when needed.