Agent skill

scene-sequencing

Structure scenes and control pacing using scene-sequel rhythm. Use when individual scenes work but don't accumulate, when pacing feels off (too rushed or too slow), when transitions feel mechanical, or when readers can follow but aren't compelled forward. Based on Dwight Swain's Goal-Conflict-Disaster and Reaction-Dilemma-Decision structure.

Stars 44
Forks 8

Install this agent skill to your Project

npx add-skill https://github.com/jwynia/agent-skills/tree/main/skills/creative/fiction/structure/scene-sequencing

Metadata

Additional technical details for this skill

mode
diagnostic+assistive
type
diagnostic
author
jwynia
domain
fiction
version
1.0

SKILL.md

Scene Sequencing: Pacing Skill

You help writers structure scenes and control narrative pacing using the scene-sequel rhythm.

Core Principle

The fundamental unit of pacing is not the scene alone, but the scene-sequel pair. Scenes create tension; sequels process it. The alternation creates peaks and valleys that make stories readable.

Scene Structure: Goal → Conflict → Disaster

Goal

What does the POV character want in this scene?

  • Specific and concrete
  • Achievable within the scene
  • Connected to larger story goals
  • Clear to reader within first beats

Conflict

Opposition to the goal that escalates within the scene.

  • Another character with different agenda
  • Environmental obstacle or time pressure
  • Internal resistance (fear, doubt, values)

Static conflict is boring. Each beat should make the goal harder.

Disaster

Scene ends with one of these outcomes (in order of narrative power):

  1. Yes, but... — Goal achieved, new problem created (strongest)
  2. No, and furthermore... — Goal failed, situation worse
  3. No — Goal failed, must try again
  4. Yes — Goal achieved cleanly (use sparingly—kills tension)

Sequel Structure: Reaction → Dilemma → Decision

Reaction

Emotional response to disaster. Lets reader:

  • Process what happened
  • Connect with character's emotional state
  • Breathe between high-tension scenes

Can be brief (a sentence) or extended (pages).

Dilemma

Character faces choice with no good options. Previous disaster has:

  • Closed some paths
  • Revealed new information
  • Created competing priorities

Dilemma must feel genuinely difficult.

Decision

Character commits to action, which becomes the goal of the next scene.

Pacing Control

The ratio of scene to sequel controls tempo:

More Scene More Sequel
Fast-paced Slow-paced
Action-heavy Reflective
Thriller feel Literary feel
Reader breathless Reader contemplative

Key technique: Compress or expand sequels to control tempo. Scenes run at natural length; sequels are your pacing lever.

Scene-Level Diagnostic

Missing Goal

"What does the character want here?"

  • If you can't answer clearly, scene lacks direction
  • Fix: Establish goal in first paragraph

Static Conflict

"Does the opposition escalate?"

  • If conflict stays at same level, scene feels flat
  • Fix: Each beat makes goal harder to achieve

Weak Disaster

"Is the outcome too clean?"

  • "Yes" endings without complications drain tension
  • Fix: Add a "but" or "and furthermore"

Missing Sequel

"Did we process the previous scene?"

  • Scene-to-scene jumps without sequels exhaust readers
  • Fix: Even brief reaction paragraph helps

Too Much Sequel

"Are we wallowing in reaction?"

  • Extended introspection without action stalls momentum
  • Fix: Compress to essential beats, move to decision

Writing Modes in Scenes

Mode Best For Common In
Action Scene conflict Scenes
Dialogue Character interaction Scenes
Description Setting, slowing pace Scene openings, Sequels
Introspection Processing events Sequels
Summarization Time compression Between scenes

Mode should match function. Action in sequels feels rushed. Introspection in action kills momentum.

What You Do

  1. Ask about the goal — What does character want in this scene?
  2. Check escalation — Does conflict intensify?
  3. Examine the disaster — Is it too clean?
  4. Find the sequel — Is there processing time?
  5. Map the ratio — More scene or more sequel? Does that match intent?
  6. Trace the chain — Does decision lead to next scene's goal?

What You Don't Do

  • Prescribe specific scene lengths
  • Enforce rigid templates
  • Demand sequel after every scene (pacing varies)
  • Choose what should happen in scenes

Example Interaction

Writer: "The middle of my story feels exhausting but also slow somehow."

Your approach:

  1. Ask: "Walk me through a typical chapter—what happens?"
  2. Check for relentless scenes: "Is there processing time between action sequences?"
  3. Check for scene goals: "In the last scene you wrote, what did the character want?"
  4. Probe disaster quality: "How did that scene end? Did they get what they wanted?"
  5. If clean victories: "That might be draining tension. What 'but' could you add?"
  6. If missing sequels: "Adding even a paragraph of reaction before the next scene helps readers catch up"

Anti-Patterns

1. The Relentless Scene

Pattern: Pure action with no processing time—scene after scene of conflict without sequel beats. Why it fails: Reader becomes numb. Without processing time, emotional stakes flatten. Each new disaster hits with diminishing impact. The reader can't catch up. Fix: Insert sequel beats even in fast-paced stories. Even a paragraph of reaction helps. Compression is fine; elimination exhausts.

2. The Wallowing Sequel

Pattern: Pages of introspection without decision—extended internal monologue going in circles. Why it fails: Reader loses patience. Sequels exist to process and decide, not to wallow. Without forward motion toward decision, introspection becomes self-indulgence. Fix: Dilemma must lead to decision; decision to action. Time-box sequels. If the character isn't moving toward a choice, compress or cut.

3. The Arbitrary Disaster

Pattern: Scene outcome disconnected from scene events—disaster that appears from nowhere to create drama. Why it fails: Readers sense manipulation. Disaster should be logical consequence of the conflict, not authorial intervention. Unmotivated disaster breaks trust. Fix: Trace the chain backward. How did scene conflict logically produce this disaster? If you can't answer, the disaster is arbitrary. Rework the conflict to set up the disaster.

4. The Clean Victory

Pattern: Character achieves goal without complications—scenes ending with simple "yes." Why it fails: Clean victories drain tension. Each unqualified success makes the next challenge feel less dangerous. Readers stop worrying. Fix: Add a "but" or "and furthermore." Goal achieved but new problem created. Victory came but cost more than expected. Simple success is rare; complications are normal.

5. Missing Goal

Pattern: Scene begins without clear character goal—things happen but there's no drive. Why it fails: Without goal, there's no conflict (nothing to oppose). Without conflict, there's no disaster (nothing to fail). The scene becomes description, not story. Fix: Establish goal in first paragraph. What does the POV character want in this scene specifically? If you can't answer clearly, the scene lacks direction.

Available Tools

analyze-scene.ts

Analyzes scene text for structure elements. Use when you need quick diagnostic on a specific scene.

bash
# Analyze a scene file
deno run --allow-read scripts/analyze-scene.ts scene.txt

# Analyze text directly
deno run --allow-read scripts/analyze-scene.ts --text "She needed to find the key..."

# Get JSON output for further processing
deno run --allow-read scripts/analyze-scene.ts scene.txt --json

What it detects:

  • Goal indicators (want, need, trying to)
  • Conflict indicators (but, blocked, obstacle)
  • Disaster indicators (failed, worse, trapped)
  • Reaction indicators (felt, emotion, shock)
  • Dilemma indicators (choice, either, what if)
  • Decision indicators (decided, will, plan)

Output includes:

  • Scene/sequel ratio assessment
  • Pacing classification (action-heavy, balanced, reflective)
  • Missing element warnings
  • Specific recommendations

When to use:

  • Quick diagnostic on a draft scene
  • Identifying why a scene feels off
  • Checking pacing across multiple scenes
  • Getting specific recommendations before deeper analysis

Output Persistence

This skill writes primary output to files so work persists across sessions.

Output Discovery

Before doing any other work:

  1. Check for context/output-config.md in the project
  2. If found, look for this skill's entry
  3. If not found or no entry for this skill, ask the user first:
    • "Where should I save output from this scene-sequencing session?"
    • Suggest: explorations/pacing/ or a sensible location for this project
  4. Store the user's preference:
    • In context/output-config.md if context network exists
    • In .scene-sequencing-output.md at project root otherwise

Primary Output

For this skill, persist:

  • Pacing diagnosis - scene/sequel balance, rhythm issues
  • Scene analysis - goal, conflict, disaster for each scene
  • Sequel analysis - reaction, dilemma, decision elements
  • Recommendations - specific interventions for pacing issues

Conversation vs. File

Goes to File Stays in Conversation
Scene-by-scene breakdown Discussion of specific scenes
Pacing diagnosis Clarifying questions
Recommended interventions Writer's structural decisions
Scene/sequel ratio assessment Real-time feedback

File Naming

Pattern: {story}-pacing-{date}.md Example: novel-chapter5-pacing-2025-01-15.md

Integration

Inbound (feeds into this skill)

Skill What it provides
story-sense Diagnosis that pacing is the problem area
key-moments Emotional beats that need scene structure
outline-collaborator Scene-level structure to analyze for pacing

Outbound (this skill enables)

Skill What this provides
drafting Properly paced scenes ready for prose generation
story-collaborator Scene structures to generate prose within
revision Pacing diagnosis for revision passes

Complementary

Skill Relationship
key-moments Key-moments identifies what emotional beats matter; scene-sequencing structures how to deliver them
dialogue Scene-sequencing handles scene-level structure; dialogue operates within scenes at the exchange level

Expand your agent's capabilities with these related and highly-rated skills.

jwynia/agent-skills

document-to-narration

Convert written documents to narrated video scripts with TTS audio and word-level timing. Use when preparing essays, blog posts, or articles for video narration. Outputs scene files, audio, and VTT with precise word timestamps. Keywords: narration, voiceover, TTS, scenes, audio, timing, video script, spoken.

44 8
Explore
jwynia/agent-skills

shadcn-layouts

Generate correct shadcn/Tailwind layouts by applying CSS mental models. This skill should be used when the user asks to 'create a shadcn layout', 'fix layout issues', 'debug CSS height problems', 'make scrolling work', or has issues with Tailwind flex/grid. Keywords: shadcn, Tailwind, layout, CSS, flex, grid, height, scroll, overflow.

44 8
Explore
jwynia/agent-skills

frontend-design

Create distinctive, production-grade frontend interfaces with high design quality. Provides analysis tools for auditing existing designs and generation tools for creating color palettes, typography systems, design tokens, and component templates. Supports React, Vue, Svelte, and vanilla HTML/CSS. Use when building web components, pages, or applications. Keywords: design, UI, frontend, CSS, components, palette, typography, tokens, accessibility.

44 8
Explore
jwynia/agent-skills

react-pwa

44 8
Explore
jwynia/agent-skills

pwa-development

Implement Progressive Web App features for React and Svelte projects. This skill should be used when the user asks to 'make a PWA', 'add offline support', 'create a service worker', 'fix caching issues', or wants installable web apps. Keywords: PWA, service worker, offline, manifest, caching, installable, Workbox, vite-pwa.

44 8
Explore
jwynia/agent-skills

mastra-hono

Develop AI agents, tools, and workflows with Mastra v1 Beta and Hono servers. This skill should be used when creating Mastra agents, defining tools with Zod schemas, building workflows with step data flow, setting up Hono API servers with Mastra adapters, or implementing agent networks. Keywords: mastra, hono, agent, tool, workflow, AI, LLM, typescript, API, MCP.

44 8
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results