Storyboard Manager

Storyboard Manager

Overview

The Storyboard Manager skill equips Claude with specialized knowledge and tools for creative writing workflows. It provides frameworks for character development, story structure patterns, automated timeline tracking, and consistency checking across narrative projects. This skill automatically adapts to various storyboard folder structures while maintaining best practices for novel, screenplay, and serialized fiction writing.

Core Capabilities

The skill provides four main capabilities:

1. Character Development & Management

Support creating deep, consistent character profiles with backstories, arcs, and relationships.

2. Story Planning & Structure

Guide plot development using established frameworks (Three-Act, Hero's Journey, Save the Cat, etc.) and help organize narrative elements.

3. Chapter & Scene Writing

Generate chapter content, scene breakdowns, and dialogue that maintains consistency with established characters and plot.

4. Timeline Tracking & Consistency Checking

Use automated tools to verify chronological consistency, character continuity, and world-building coherence.

Detecting Project Structure

The Storyboard Manager automatically detects and adapts to various folder organizations. Look for these common directory patterns:

Character folders: characters/, Characters/, cast/, Cast/ Chapter folders: chapters/, Chapters/, scenes/, Scenes/, story/ Planning folders: story-planning/, planning/, outline/, notes/ Summary files: summary.md, README.md, overview.md

When triggered, scan the project root to identify the structure and adjust workflows accordingly. If no standard structure exists, recommend organizing files using the pattern: characters/, chapters/, story-planning/, and summary.md.

Workflow Decision Tree

Use this decision tree to determine the appropriate workflow:

User Request
├─ Character-related? ("develop character," "create backstory," "character arc")
│  └─ → Character Development Workflow
│
├─ Planning/Plot? ("outline story," "plan act 2," "plot structure")
│  └─ → Story Planning Workflow
│
├─ Writing content? ("write chapter," "generate scene," "continue story")
│  └─ → Chapter/Scene Writing Workflow
│
└─ Checking/Analysis? ("check consistency," "track timeline," "find contradictions")
   ├─ Timeline? → Use timeline_tracker.py script
   └─ Consistency? → Use consistency_checker.py script

Character Development Workflow

Step 1: Gather Context

Before developing a character, read existing character files to understand:

• Established naming conventions and profile format
• Existing characters and relationships
• Story genre and tone
• Character archetypes already in use

Use the Read tool to examine existing character files in the characters directory.

Step 2: Access Character Development Framework

When detailed character guidance is needed, read references/character_development.md which contains:

• Core character elements (personality, motivation, goals)
• Backstory framework (ghost/wound, formative relationships)
• Character arc types (positive change, flat, negative)
• Relationship dynamics
• Voice development techniques
• Consistency guidelines

To efficiently find specific guidance, use Grep to search for relevant sections:

# Example: Find guidance on character arcs
grep -i "character arc" references/character_development.md

Step 3: Develop Character Profile

Create or enhance character profiles with these essential elements:

Basic Information

• Name, age, role, physical appearance
• Key personality traits (both positive and negative)

Background

• Origin and formative experiences
• Ghost/wound that shapes their behavior
• Key relationships and family dynamics

Character Arc

• Starting belief or flaw
• Want vs. Need (external goal vs. internal growth)
• Transformation journey
• End state

Relationships

• Connections to other characters
• Dynamic types (ally, rival, mentor, etc.)
• How relationships evolve

Unique Elements

• Abilities, skills, or special knowledge
• Secrets or hidden aspects
• Voice/speech patterns
• Character-specific quirks

Step 4: Ensure Consistency

Cross-reference with:

• Existing character profiles (avoid redundancy in roles/traits)
• Story planning documents (ensure alignment with plot needs)
• Summary/overview (match genre and tone)

Step 5: Create or Update File

Write the character profile to characters/[character-name].md using markdown format. Match the existing style and structure found in other character files.

Story Planning Workflow

Step 1: Assess Current Planning State

Read existing planning documents to understand:

• Story concept and premise
• Established plot points or outline
• Target audience and genre
• Themes and central questions
• Planned structure (if any)

Look in folders like story-planning/, outline/, or files like summary.md.

Step 2: Access Story Structure Reference

For detailed structural guidance, read references/story_structures.md which includes:

• Three-Act Structure
• Hero's Journey (Campbell's Monomyth)
• Save the Cat Beat Sheet
• Character arc templates
• Scene structure components
• Pacing guidelines by genre
• Subplot integration techniques
• Genre-specific structures

Use Grep to find specific frameworks:

# Example: Find Three-Act Structure details
grep -A 20 "Three-Act Structure" references/story_structures.md

Step 3: Determine Structure Needs

Based on the user's request and story genre, recommend appropriate frameworks:

• Thriller/Mystery: Three-Act with strong midpoint reversal
• Fantasy/Adventure: Hero's Journey for quest narratives
• YA/Contemporary: Save the Cat for tight emotional beats
• Literary Fiction: Focus on character arc structure
• Romance: Genre-specific structure with relationship beats

Step 4: Develop Planning Document

Create or enhance planning documents with:

Story Overview

• Premise in 2-3 sentences
• Genre, target audience, tone
• Central themes and questions

Plot Structure

• Act/chapter breakdown with key events
• Inciting incident and plot points
• Midpoint twist or revelation
• Climax and resolution

Character Arcs

• How each main character transforms
• Arc integration with plot beats

World-Building Elements (if applicable)

• Setting and locations
• Magic systems or technology
• Social structures or rules
• Historical context

Timeline

• Story duration
• Key event sequence
• Pacing considerations

Step 5: Create Planning File

Write planning documents to story-planning/[document-name].md. Use clear hierarchical structure with markdown headers for easy navigation.

Chapter & Scene Writing Workflow

Step 1: Gather Story Context

Before writing any content, comprehensively read:

Character Files: All relevant character profiles to understand voices, motivations, arcs Planning Documents: Story structure, plot points, current story position Previous Chapters: Recent chapters to maintain continuity (read at least 1-2 prior chapters) Summary: Overall story premise and themes

This ensures the new content aligns with established elements.

Step 2: Identify Chapter Requirements

Determine:

• Story Position: Where does this fit in the overall structure?
• POV Character: Whose perspective?
• Scene Goal: What does the POV character want in this scene?
• Conflict: What opposes their goal?
• Outcome: How does the scene end? (typically with a complication)
• Character Development: What arc beats occur here?
• Plot Advancement: What story questions are raised or answered?

Step 3: Structure the Chapter

Apply scene structure components:

Scene (Action)

1. Goal - What the POV character pursues
2. Conflict - Opposition encountered
3. Disaster - Negative outcome that propels forward

Sequel (Reaction)

1. Reaction - Emotional response to disaster
2. Dilemma - Processing options
3. Decision - Choice leading to next goal

Alternate between high-tension (action, conflict) and low-tension (reflection, world-building) beats for pacing.

Step 4: Write with Character Consistency

Maintain character voice by referencing:

• Established personality traits
• Speech patterns and vocabulary
• Behavioral patterns (under stress, when happy, decision-making style)
• Current position in character arc
• Relationships with other characters present

Step 5: Integrate Timeline Markers

Include timeline references to maintain chronological clarity:

• Explicit markers: "Day 3," "Two weeks later"
• Implicit markers: Time of day, seasonal cues, event references
• Format: **Timeline:** Day 5, Evening in chapter header or as section break

Step 6: Create Chapter File

Write chapter content to chapters/chapter-[number].md or chapters/[chapter-name].md. Include:

Chapter Header

# Chapter [Number]: [Optional Title]

**Timeline:** [When this occurs]
**POV:** [Character name]
**Location:** [Where this takes place]

Chapter Content

• Scene-by-scene breakdown
• Dialogue and action
• Character thoughts (for POV character)
• Descriptive elements

Step 7: Note Continuity Elements

After writing, document any new information introduced:

• Character revelations or development
• Plot points or clues
• World-building details
• Timeline events

This helps maintain consistency in future chapters.

Timeline Tracking

When to Use Timeline Tracking

Invoke the timeline tracker when:

• User requests timeline analysis or event sequencing
• Checking chronological consistency
• Planning event order across chapters
• Identifying unmarked time periods

Running the Timeline Tracker

Execute the script from the project root:

python3 .claude/skills/storyboard-manager/scripts/timeline_tracker.py . --output markdown

Output format options:

• markdown - Human-readable report (default)
• json - Structured data for further processing

Understanding Timeline Output

The script provides:

Statistics

• Total events tracked
• Total characters appearing
• Events per character

Timeline View

• Chronological sequence of events
• Chapter/scene locations
• Characters present in each event
• Preview of event content

Warnings

• Events without timeline markers
• Characters mentioned but not defined in character files

Acting on Timeline Results

After running the tracker:

1. Review warnings - Address missing timeline markers by adding them to chapters
2. Check sequence - Verify events occur in logical order
3. Identify gaps - Look for time periods without events
4. Character tracking - Ensure characters appear consistently with their arc

Add timeline markers to chapters where missing:

**Timeline:** Day 7, Morning

Or use inline markers:

Three days had passed since the incident...

Consistency Checking