New: Earn 20% as an AgentAlley affiliate. Share your link and earn on every sale you refer. Join now New: Earn 20% as an affiliate. Join now

Plan a scene, scene structure, sequel scene

Scene craft

by danjdewhurst · MIT license · ★ 241 on GitHub · updated Sep 22

Scene craft cover

This skill should be used when the user asks to "plan a scene", "scene structure", "sequel scene", "dialogue subtext", "deep POV", "psychic distance", "try fail", "scene cards", "exposition", "info dump", "flashback", "time skip",…

---
name: scene-craft
description: This skill should be used when the user asks to "plan a scene", "scene structure", "sequel scene", "dialogue subtext", "deep POV", "psychic distance", "try fail", "scene cards", "exposition", "info dump", "flashback", "time skip", "story opening", "first page hook", "introduce a character", or wants scene-level craft for drafting or revision.
---

# Scene Craft

## Overview

Plan and check scenes at the scene grain — the layer between plot beats and
chapter prose. Covers the missing half of the chapter-writing scene model
(Scene **and** Sequel), try/fail escalation, scene cards, dialogue subtext,
deep POV and psychic distance, exposition handling, flashbacks and time
skips, and openings. Use during chapter planning, before drafting, and in
revision when a scene feels flat.

## Prerequisites

Overview

Plan and check scenes at the scene grain — the layer between plot beats and chapter prose. Covers the missing half of the chapter-writing scene model (Scene and Sequel), try/fail escalation, scene cards, dialogue subtext, deep POV and psychic distance, exposition handling, flashbacks and time skips, and openings. Use during chapter planning, before drafting, and in revision when a scene feels flat.

The SKILL.md below is the copy AgentAlley read and checked. The repo has changed it since; the other files are from commit 28817a2.

Manual install (npx, ZIP)
Claude Codenpx skills add danjdewhurst/story-skills --skill scene-craft -g -a claude-code
Claude Code (manual)mkdir -p ~/.claude/skills && curl -sL https://codeload.github.com/danjdewhurst/story-skills/tar.gz/28817a272657 \ | tar -xz -C ~/.claude/skills --strip-components=2 story-skills-28817a272657/skills/scene-craft
Windows (PowerShell)New-Item -ItemType Directory -Force "$HOME\.claude\skills" | Out-Null; Invoke-WebRequest "https://m.agentalley.io/zip/64ec5491f8794511f122/scene-craft.zip" -OutFile "$env:TEMP\scene-craft.zip"; Expand-Archive "$env:TEMP\scene-craft.zip" -DestinationPath "$HOME\.claude\skills" -Force
Claude.ai / desktopDownload the ZIP and upload it under Settings → Capabilities → Skills.
Codex, Cursor, other agentsPoint them at SKILL.md. The other files are plain text.

Connects with Agent Alley MCP · agentalley.io/mcp

Files included

  • SKILL.md6.7 KB
  • references/8 files · 26.7 KB
Read the files here
danjdewhurst/28817a29 files
Shared references1SKILL.md reads these from elsewhere in the repo. Not in the ZIP.Get them on GitHub ↗
SKILL.md
Show the full text103 lines

Scene Craft

Overview

Plan and check scenes at the scene grain — the layer between plot beats and chapter prose. Covers the missing half of the chapter-writing scene model (Scene and Sequel), try/fail escalation, scene cards, dialogue subtext, deep POV and psychic distance, exposition handling, flashbacks and time skips, and openings. Use during chapter planning, before drafting, and in revision when a scene feels flat.

Prerequisites

A story project must already exist (created via the story-init skill), with characters defined (character-management) and a plot structure in place (plot-structure). This skill extends chapter-writing; it does not replace the outline-first drafting workflow.

Workflow

  1. Choose the craft layer. Identify which scene-grain problem this is:
    • Scene feels like incidents with no breathing room → references/scene-sequel.md
    • Middle of the chapter sags or resolves too easily → references/try-fail.md
    • Chapter has multiple POVs/timelines to order → references/scene-cards.md
    • Conversation reads flat or voices blur → references/dialogue-subtext.md
    • Narration feels distant or head-hops → references/deep-pov.md
    • Worldbuilding facts are piling up undelivered → references/exposition.md
    • Past events or a time jump are needed → references/flashbacks-time.md
    • Starting the book or a chapter, or introducing a character → references/openings.md
  2. Read the relevant reference(s). Each file carries its own checklists and planning fields; apply them, don't paraphrase them.
  3. Clarify missing inputs before planning or editing. Ask the user for any required inputs you cannot establish from the project files — scene purpose, viewpoint, location, canon-changing intent, and the applicable craft layer. Never guess at these or proceed on assumptions; a wrong guess edits canon. Only continue to step 4 once every required input is known.
  4. Plan before prose. For the scene in question, write the planning inputs the reference requires (sequel beats, try/fail positions, subtext wants, zoom level, exposition audit, flashback trigger, hook check) into the chapter outline or the scene's planning notes before drafting or revising.
  5. Record machine-readable state. Update the scene file in scenes/:
    • Set sequel: true/false and fill the dilemma: field plus the ## Sequel section (reaction/dilemma/decision) for scenes with sequel content (see references/scene-sequel.md)
    • Add flashback-to: (freeform note of the flashed-back moment, validated as a scalar by story validate but not used by continuity checks) and move flashback-only characters to mentions (see references/flashbacks-time.md)
    • Keep state-changes current for every change the scene makes
  6. Run the reference's checklist against the draft or the revision plan (try/fail checklist, deep-POV filter-word scan, tag-swap test, first-page hook check).
  7. Hand off cleanly. Scene/sequel planning feeds the chapter-writing drafting workflow; theme-audit findings feed revision-continuity. When a scene decision changes canon (new knowledge, moved objects, changed relationships), update continuity/state.md and the affected entity files (bidirectional links, per the story-init conventions).

Conventions

  • Scene ids stay chapter-{NN}-scene-{NN}; scene files live in scenes/ with kebab-case filenames.
  • All planning metadata (dilemma, decision, subtext wants, psychic-distance level) lives in frontmatter or a ## Planning / ## Scene Card section of the scene file — never only in chat.
  • characters vs mentions follows the story-init rule: characters present in-scene under characters; remembered, recorded, or flashback-only characters under mentions.
  • Do not overwrite chapter prose merely to satisfy a craft checklist. Flag intentional deviations (e.g. a deliberate info dump as a stylistic device) in the scene file's planning notes so a later audit doesn't "fix" them.

CLI Maintenance

Use the Story CLI when it is available. If story is not installed, use bun run story -- from the Story Skills repository checkout or the bundled fallback node ../story-maintenance/scripts/story.js with the same arguments, resolving the path relative to this skill folder. If no CLI is available, perform the registry, backlink, and word-count checks manually.

After adding or revising scene records:

story reindex .
story links .
story validate .
story continuity .

Reference Files

  • references/scene-sequel.md - Sequel mechanics: reaction → dilemma → decision (Dwight Swain's scene framework)
  • references/try-fail.md - Try/fail escalation cycles and the Five Commandments scene shape
  • references/scene-cards.md - Scene card unit (start state → change → end state), reordering, POV braiding
  • references/dialogue-subtext.md - Subtext as planning input, dialogue-as-negotiation, voice differentiation, tag-swap test
  • references/deep-pov.md - Psychic distance zoom levels and checkable deep-POV rules
  • references/exposition.md - Drip-feed, conflict-carried exposition, in-world documents, info-dump warning
  • references/flashbacks-time.md - Flashback entry/exit mechanics, tension-cheat warning, time-skip conventions
  • references/openings.md - In medias res, "enter late, leave early", first-page hook check, character introduction technique
1---
2name: scene-craft
3description: This skill should be used when the user asks to "plan a scene", "scene structure", "sequel scene", "dialogue subtext", "deep POV", "psychic distance", "try fail", "scene cards", "exposition", "info dump", "flashback", "time skip", "story opening", "first page hook", "introduce a character", or wants scene-level craft for drafting or revision.
4---
5 
6# Scene Craft
7 
8## Overview
9 
10Plan and check scenes at the scene grain — the layer between plot beats and
11chapter prose. Covers the missing half of the chapter-writing scene model
12(Scene **and** Sequel), try/fail escalation, scene cards, dialogue subtext,
13deep POV and psychic distance, exposition handling, flashbacks and time
14skips, and openings. Use during chapter planning, before drafting, and in
15revision when a scene feels flat.
16 
17## Prerequisites
18 
19A story project must already exist (created via the story-init skill), with
20characters defined (character-management) and a plot structure in place
21(plot-structure). This skill extends chapter-writing; it does not replace the
22outline-first drafting workflow.
23 
24## Workflow
25 
261. **Choose the craft layer.** Identify which scene-grain problem this is:
27 - Scene feels like incidents with no breathing room → `references/scene-sequel.md`
28 - Middle of the chapter sags or resolves too easily → `references/try-fail.md`
29 - Chapter has multiple POVs/timelines to order → `references/scene-cards.md`
30 - Conversation reads flat or voices blur → `references/dialogue-subtext.md`
31 - Narration feels distant or head-hops → `references/deep-pov.md`
32 - Worldbuilding facts are piling up undelivered → `references/exposition.md`
33 - Past events or a time jump are needed → `references/flashbacks-time.md`
34 - Starting the book or a chapter, or introducing a character → `references/openings.md`
352. **Read the relevant reference(s).** Each file carries its own checklists
36 and planning fields; apply them, don't paraphrase them.
373. **Clarify missing inputs before planning or editing.** Ask the user for
38 any required inputs you cannot establish from the project files — scene
39 purpose, viewpoint, location, canon-changing intent, and the applicable
40 craft layer. Never guess at these or proceed on assumptions; a wrong
41 guess edits canon. Only continue to step 4 once every required input
42 is known.
434. **Plan before prose.** For the scene in question, write the planning
44 inputs the reference requires (sequel beats, try/fail positions, subtext
45 wants, zoom level, exposition audit, flashback trigger, hook check) into
46 the chapter outline or the scene's planning notes before drafting or
47 revising.
485. **Record machine-readable state.** Update the scene file in `scenes/`:
49 - Set `sequel: true/false` and fill the `dilemma:` field plus the
50 `## Sequel` section (reaction/dilemma/decision) for scenes with
51 sequel content (see `references/scene-sequel.md`)
52 - Add `flashback-to:` (freeform note of the flashed-back moment,
53 validated as a scalar by `story validate` but not used by continuity
54 checks) and move flashback-only characters to `mentions`
55 (see `references/flashbacks-time.md`)
56 - Keep `state-changes` current for every change the scene makes
576. **Run the reference's checklist** against the draft or the revision plan
58 (try/fail checklist, deep-POV filter-word scan, tag-swap test, first-page
59 hook check).
607. **Hand off cleanly.** Scene/sequel planning feeds the chapter-writing
61 drafting workflow; theme-audit findings feed revision-continuity. When a
62 scene decision changes canon (new knowledge, moved objects, changed
63 relationships), update `continuity/state.md` and the affected entity
64 files (bidirectional links, per the story-init conventions).
65 
66## Conventions
67 
68- Scene ids stay `chapter-{NN}-scene-{NN}`; scene files live in `scenes/`
69 with kebab-case filenames.
70- All planning metadata (dilemma, decision, subtext wants, psychic-distance
71 level) lives in frontmatter or a `## Planning` / `## Scene Card` section
72 of the scene file — never only in chat.
73- `characters` vs `mentions` follows the story-init rule: characters present
74 in-scene under `characters`; remembered, recorded, or flashback-only
75 characters under `mentions`.
76- Do not overwrite chapter prose merely to satisfy a craft checklist. Flag
77 intentional deviations (e.g. a deliberate info dump as a stylistic device)
78 in the scene file's planning notes so a later audit doesn't "fix" them.
79 
80## CLI Maintenance
81 
82Use the Story CLI when it is available. If `story` is not installed, use `bun run story --` from the Story Skills repository checkout or the bundled fallback `node ../story-maintenance/scripts/story.js` with the same arguments, resolving the path relative to this skill folder. If no CLI is available, perform the registry, backlink, and word-count checks manually.
83 
84After adding or revising scene records:
85 
86```shell
87story reindex .
88story links .
89story validate .
90story continuity .
91```
92 
93## Reference Files
94 
95- **`references/scene-sequel.md`** - Sequel mechanics: reaction → dilemma → decision (Dwight Swain's scene framework)
96- **`references/try-fail.md`** - Try/fail escalation cycles and the Five Commandments scene shape
97- **`references/scene-cards.md`** - Scene card unit (start state → change → end state), reordering, POV braiding
98- **`references/dialogue-subtext.md`** - Subtext as planning input, dialogue-as-negotiation, voice differentiation, tag-swap test
99- **`references/deep-pov.md`** - Psychic distance zoom levels and checkable deep-POV rules
100- **`references/exposition.md`** - Drip-feed, conflict-carried exposition, in-world documents, info-dump warning
101- **`references/flashbacks-time.md`** - Flashback entry/exit mechanics, tension-cheat warning, time-skip conventions
102- **`references/openings.md`** - In medias res, "enter late, leave early", first-page hook check, character introduction technique
103 
View all files on GitHub →

Details

Updated
Sep 22, 2026
License
MIT
Stars on the repo
★ 241
Checked
Source
danjdewhurst/story-skills ↗
Creator
danjdewhurst · 13 listings
View creator

Similar skills

See all →
SkillReverse engineer native, managed, Electron/JavaScriptREAmorluto/rea · by morlutoReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.★ 316k GitHub starsSkillBrainstorms ideas into designs before any creative workBrainstorming Ideas Into Designsobra/superpowers · by obraYou MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation.★ 290k GitHub starsSkillRequires technical rigor and verificationCode Review Receptionobra/superpowers · by obraUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation★ 290k GitHub starsSkillDiagnosis loop for hard bugs and performance regressionsDiagnosing bugsmattpocock/skills · by mattpocockDiagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.★ 267k GitHub starsSkillImplement the result of /to-spec and /to-tickets in codeImplement specmattpocock/skills · by mattpocockImplement the result of /to-spec and /to-tickets in code.★ 267k GitHub starsSkillWriting a PR bodymattpocock/skills · by mattpocockUse when writing a PR body.★ 267k GitHub stars

More from danjdewhurst

SkillWrite a chapter, next chapter, chapter outlineChapter writingdanjdewhurst/story-skills · by danjdewhurstThis skill should be used when the user asks to "write a chapter", "next chapter", "chapter outline", "draft chapter", "continue the story", "write a scene", "outline a chapter", or wants to write prose for a story project.★ 241 GitHub starsSkillCreate a character, update a character, add a characterCharacter managementdanjdewhurst/story-skills · by danjdewhurstThis skill should be used when the user asks to "create a character", "update a character", "add a character", "build a family tree", "character relationships", "character timeline", "character arc", "character profile", or needs to manage characters in a story project.★ 241 GitHub starsSkillPantsing, discovery write, write without an outlineDiscovery draftingdanjdewhurst/story-skills · by danjdewhurstThis skill should be used when the user asks to "pantsing", "discovery write", "write without an outline", "discovery draft", "write into the dark", "story kernel", "reconcile a chapter", "reverse outline", "cut a subplot", "dead end", "drafting sprint", "writing cadence", or wants to draft a story by discovery with retrospective bible reconciliation.★ 241 GitHub starsSkillProcess beta reader feedback, alpha reader feedbackFeedback triagedanjdewhurst/story-skills · by danjdewhurstThis skill should be used when the user asks to "process beta reader feedback", "alpha reader feedback", "feedback round", "synthesize reader feedback", "reader notes", "beta feedback", "readiness check", or wants to collect, reconcile, and act on external reader feedback for a story project.★ 241 GitHub starsSkillMystery, fair play, clue, red herring, romance beats, HEAGenre craftdanjdewhurst/story-skills · by danjdewhurstThis skill should be used when the user asks to "mystery", "fair play", "clue", "red herring", "romance beats", "HEA", "thriller", "ticking clock", "horror", "dread", "MG", "YA", "middle grade", "young adult", "science fiction", "sci-fi", "serial", "episodic", "web serial", "genre conventions", or wants genre-specific structural craft for a story project.★ 241 GitHub starsSkillCreate a plot arc, story structure, add a plot pointPlot structuredanjdewhurst/story-skills · by danjdewhurstThis skill should be used when the user asks to "create a plot arc", "story structure", "add a plot point", "story timeline", "track foreshadowing", "pacing", "act structure", "story arc", "plot outline", or wants to plan and manage the narrative structure of a story.★ 241 GitHub stars