Plan a scene, scene structure, sequel scene
Scene craft

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.
Manual install (npx, ZIP)
npx skills add danjdewhurst/story-skills --skill scene-craft -g -a claude-codemkdir -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-craftNew-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" -ForceConnects with Agent Alley MCP · agentalley.io/mcp
Files included
SKILL.md6.7 KBreferences/8 files · 26.7 KB
Read the files here
danjdewhurst/
- deep-pov.md3.5 KB
- dialogue-subtext.md3.7 KB
- exposition.md3.1 KB
- flashbacks-time.md3.3 KB
- openings.md3.1 KB
- scene-cards.md2.7 KB
- scene-sequel.md3.6 KB
- try-fail.md3.7 KB
Shared references1SKILL.md reads these from elsewhere in the repo. Not in the ZIP.
Get them on GitHub ↗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
- 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
- Scene feels like incidents with no breathing room →
- Read the relevant reference(s). Each file carries its own checklists and planning fields; apply them, don't paraphrase them.
- 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.
- 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.
- Record machine-readable state. Update the scene file in
scenes/:- Set
sequel: true/falseand fill thedilemma:field plus the## Sequelsection (reaction/dilemma/decision) for scenes with sequel content (seereferences/scene-sequel.md) - Add
flashback-to:(freeform note of the flashed-back moment, validated as a scalar bystory validatebut not used by continuity checks) and move flashback-only characters tomentions(seereferences/flashbacks-time.md) - Keep
state-changescurrent for every change the scene makes
- Set
- 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).
- 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.mdand the affected entity files (bidirectional links, per the story-init conventions).
Conventions
- Scene ids stay
chapter-{NN}-scene-{NN}; scene files live inscenes/with kebab-case filenames. - All planning metadata (dilemma, decision, subtext wants, psychic-distance
level) lives in frontmatter or a
## Planning/## Scene Cardsection of the scene file — never only in chat. charactersvsmentionsfollows the story-init rule: characters present in-scene undercharacters; remembered, recorded, or flashback-only characters undermentions.- 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 shapereferences/scene-cards.md- Scene card unit (start state → change → end state), reordering, POV braidingreferences/dialogue-subtext.md- Subtext as planning input, dialogue-as-negotiation, voice differentiation, tag-swap testreferences/deep-pov.md- Psychic distance zoom levels and checkable deep-POV rulesreferences/exposition.md- Drip-feed, conflict-carried exposition, in-world documents, info-dump warningreferences/flashbacks-time.md- Flashback entry/exit mechanics, tension-cheat warning, time-skip conventionsreferences/openings.md- In medias res, "enter late, leave early", first-page hook check, character introduction technique
| 1 | |
| 2 | name scene-craft |
| 3 | 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. |
| 4 | |
| 5 | |
| 6 | # Scene Craft |
| 7 | |
| 8 | ## Overview |
| 9 | |
| 10 | Plan and check scenes at the scene grain — the layer between plot beats and |
| 11 | chapter prose. Covers the missing half of the chapter-writing scene model |
| 12 | (Scene **and** Sequel), try/fail escalation, scene cards, dialogue subtext, |
| 13 | deep POV and psychic distance, exposition handling, flashbacks and time |
| 14 | skips, and openings. Use during chapter planning, before drafting, and in |
| 15 | revision when a scene feels flat. |
| 16 | |
| 17 | ## Prerequisites |
| 18 | |
| 19 | A story project must already exist (created via the story-init skill), with |
| 20 | characters defined (character-management) and a plot structure in place |
| 21 | (plot-structure). This skill extends chapter-writing; it does not replace the |
| 22 | outline-first drafting workflow. |
| 23 | |
| 24 | ## Workflow |
| 25 | |
| 26 | **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` |
| 35 | **Read the relevant reference(s).** Each file carries its own checklists |
| 36 | and planning fields; apply them, don't paraphrase them. |
| 37 | **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. |
| 43 | **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. |
| 48 | **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 |
| 57 | **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). |
| 60 | **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 | |
| 82 | 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. |
| 83 | |
| 84 | After adding or revising scene records: |
| 85 | |
| 86 | |
| 87 | story reindex . |
| 88 | story links . |
| 89 | story validate . |
| 90 | story 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 |
Details
- Updated
- Sep 22, 2026
- License
- MIT
- Stars on the repo
- ★ 241
- Checked
- Source
- danjdewhurst/story-skills ↗
- Creator
- danjdewhurst · 13 listings
Similar skills
See all →
SkillReverse engineer native, managed, Electron/JavaScriptREA
SkillBrainstorms ideas into designs before any creative workBrainstorming Ideas Into Designs
SkillRequires technical rigor and verificationCode Review Reception
SkillDiagnosis loop for hard bugs and performance regressionsDiagnosing bugs
SkillImplement the result of /to-spec and /to-tickets in codeImplement spec
SkillWriting a PR bodyMore from danjdewhurst
SkillWrite a chapter, next chapter, chapter outlineChapter writing
SkillCreate a character, update a character, add a characterCharacter management
SkillPantsing, discovery write, write without an outlineDiscovery drafting
SkillProcess beta reader feedback, alpha reader feedbackFeedback triage
SkillMystery, fair play, clue, red herring, romance beats, HEAGenre craft
SkillCreate a plot arc, story structure, add a plot pointPlot structure