Agent skill

Scene Craft

by danjdewhurst in danjdewhurst/story-skills

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…

MITAuto-check: notesWriting & Content

Install Scene Craft

skills CLI
$ npx skills add danjdewhurst/story-skills --skill scene-craft -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install danjdewhurst/story-skills scene-craft --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/danjdewhurst/story-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/scene-craft .claude/skills/scene-craft && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
scene-craft
GitHub stars
283
Used in
1 other repo
Token cost
~2.3k tokens
SKILL.md length
1,102 words
Files
9 (incl. references)
Skills in repo
24
Repo updated
First seen
Licence
MIT

At a glance

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…

  • Works in 7 steps: Choose the craft layer. Identify which… → Read the relevant reference(s). Each… → Clarify missing inputs before planning… → …
  • Asks to plan a scene
  • SKILL.md covers Overview, Prerequisites, Workflow and Conventions, plus 3 more sections
  • Calls node

What it does

Scene Craft is an agent skill from danjdewhurst/story-skills. 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", "scene outcome", "yes-but no-and", "chapter hook", or wants scene-level craft for drafting or revision. NOT for book-level pacing or act structure (use plot-structure), or drafting the prose of a scene or chapter (use…

Its SKILL.md is about 2.3k tokens, which your agent loads only when the skill is triggered. The skill folder holds 9 other files, including reference files (for example `references/deep-pov.md`, `references/dialogue-subtext.md` and `references/exposition.md`).

It sits in Writing & Content, covering Creative writing and fiction. The repository describes itself as: Agent Skills for end-to-end story writing in markdown, packaged as Codex and Claude Code plugins. The licence is MIT.

When your agent uses it

  • Asks to plan a scene
  • Scene structure
  • Dialogue subtext
  • Psychic distance

Example prompts

  • “plan a scene”
  • “scene structure”
  • “sequel scene”
  • “/scene-craft”

Workflow steps

7 steps, taken from the first numbered list in SKILL.md.

  1. Choose the craft layer. Identify which scene-grain problem this is
  2. Read the relevant reference(s). Each file carries its own checklists
  3. Clarify missing inputs before planning or editing. Ask the user for
  4. Plan before prose. For the scene in question, write the planning
  5. Record machine-readable state. Update the scene file in scenes/
  6. Run the reference's checklist against the draft or the revision plan
  7. Hand off cleanly. Scene/sequel planning feeds the chapter-writing

What it can do on your machine

Read from SKILL.md and the folder at commit c46163b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • node

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Scene Craft loads about 2.3k tokens when it runs, and up to ~9.4k if it reads all its reference files. Until then it costs about 135 tokens; SKILL.md has 1,102 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~135
When it runs · the whole SKILL.md, loaded when a task matches
~2.3k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~9.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:109
    `bunfig.toml` (which can run code) and `.env`, and a package script runs from the checkout's root. If no CLI is availab

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from danjdewhurst/story-skills at commit c46163b, republished under its MIT licence (© danjdewhurst). 1,102 words, ~2,312 tokens.

Download SKILL.mdSave it as .claude/skills/scene-craft/SKILL.md (or your agent's skills folder). This skill also uses 8 other files; get the full folder from GitHub.
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", "scene outcome", "yes-but no-and", "chapter hook", or wants scene-level craft for drafting or revision. NOT for book-level pacing or act structure (use plot-structure), or drafting the prose of a scene or chapter (use chapter-writing).

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. Read language in story.md (a missing field means en) and plan and draft in that language. The structural tools (scene and sequel, try/fail, scene cards, psychic distance) apply in any language; the word lists and dialogue-tag advice in deep-pov.md and dialogue-subtext.md are English, so for another language look for the same effect in that language and take dialogue punctuation from the style sheet.
  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 outcome: to how the scene's goal resolves for the POV character: yes, no, yes-but, or no-and (see references/try-fail.md). Prefer the complicating yes-but and no-and; a run of clean yes outcomes drains tension
    • 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. A dated flashback warns timestamp runs backward; record that finding in continuity/exemptions.md rather than changing the date (see references/flashbacks-time.md)
    • Set date: (YYYY-MM-DD) and time: ("HH:MM" or dawn, morning, midday, afternoon, evening, night) once the scene's moment is settled, and travel-hours: (a number) when the POV character had to travel since the previous scene. Undated scenes switch off the clock and route checks in story continuity without a warning, except a scene with travel-hours above 0, which warns; story timeline shows what is still undated
    • Keep state-changes current for every change the scene makes
    • When the scene ends its chapter, set the chapter's hook: to how the chapter ends: cliffhanger, question, revelation, reversal, decision, emotional, or resolution (see references/openings.md for the first-page counterpart)
  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). If story prose reports the filter-word check skipped for the book's language, do that scan by reading. Run story pacing . to see scene outcomes, sequel counts, and chapter hooks across the book: it warns after three or more consecutive yes outcomes, four or more scene units without a sequel, and three or more chapters in a row ending on resolution.
  7. Hand off cleanly. Scene/sequel planning feeds the chapter-writing drafting workflow. 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 shared story conventions).
Show full SKILL.md (412 more words)Show less

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 the bundled fallback node ../story-maintenance/scripts/story.js with the same arguments. Use node <checkout>/bin/story.js instead only when the user names a Story Skills repository checkout or you are working in one. Write the script as an absolute path (resolve the fallback relative to this skill folder) and run it from the folder you would run story from, so . and other relative paths keep their meaning. Use Node, not Bun or a package script: Bun would load that folder's bunfig.toml (which can run code) and .env, and a package script runs from the checkout's root. If no CLI is available, perform the registry, backlink, and word-count checks manually.

After adding or revising scene records:

shell
story reindex .
story wordcount . --write
story check .
story pacing .

Reference Files

  • references/scene-sequel.md - Sequel mechanics: reaction → dilemma → decision (Dwight Swain's scene framework)
  • references/try-fail.md - Try/fail escalation cycles, scene outcome values (yes/no/yes-but/no-and), 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

Shared Conventions

Every story skill follows the shared conventions in ../story-maintenance/references/conventions.md, resolved relative to this skill folder. Read it before creating, renaming, or linking story files. If that file is missing because this skill was installed without story-maintenance, the essentials are: kebab-case ids and filenames, YAML frontmatter on every story-project file, _index.md registry tables that story reindex rebuilds (never edit them by hand), bidirectional links between entities, characters for who is on the page and mentions for who is only referred to, status: deceased plus died-in: chapter-{NN} for deaths, and no project-local generator or build scripts (run only the installed or bundled Story CLI).

© danjdewhurst, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 8 other files (references) in skills/scene-craft of danjdewhurst/story-skills.

  • SKILL.md
  • references/deep-pov.md
  • references/dialogue-subtext.md
  • references/exposition.md
  • references/flashbacks-time.md
  • references/openings.md
  • references/scene-cards.md
  • references/scene-sequel.md
  • references/try-fail.md

Open the folder on GitHubat commit c46163b

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in danjdewhurst/story-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Scene Craft next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Scene Craft compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Scene Craft this skilldanjdewhurst/story-skills2831 repos~2.3kAutomated safety check: NotesMIT
Story Multi-Perspective Reviewzenstory-ai/oh-story-claudecode7.4k3 repos~3kAutomated safety check: PassMIT
Short Web Fiction Trend Scanzenstory-ai/oh-story-claudecode7.4k2 repos~1.2kAutomated safety check: PassMIT
InkOS Creative HarnessNarcooo/inkos10k1 repos~1.1kAutomated safety check: PassAGPL-3.0
Novel Arteternityspring/shuohao-skills4.3k—~1.1kAutomated safety check: NotesApache-2.0
SepiaNanako0129/sepia3k—~3.6kAutomated safety check: PassMIT

Similar skills

  • Story Multi-Perspective Review

    zenstory-ai/oh-story-claudecode

    Reviews Chinese web-novel text with several reviewer agents in parallel, falling back to a single-agent pass, and reports structure, character, prose and setting problems with fixes.

    7.4k GitHub starsUsed in 3 repos~3k tokens
    Writing & ContentAuto-check passed
  • Short Web Fiction Trend Scan

    zenstory-ai/oh-story-claudecode

    Scans popular short web-fiction rankings on Chinese platforms such as Dianzhong and Heiyan to surface trending emotional hooks, themes and topic candidates with an expiry warning.

    7.4k GitHub starsUsed in 2 repos~1.2k tokens
    Writing & ContentAuto-check passed
  • Drives long-form fiction, scripts, storyboards, interactive films and long-document translation through InkOS, with every change made by a typed action.

    10k GitHub starsUsed in 1 repo~1.1k tokens
    Writing & ContentAuto-check passed
  • Novel Art

    eternityspring/shuohao-skills

    给 AI 短剧出美术设定集(场景 + 叙事道具):场景的设计意图、一致性锚点、光照时段变体、 空景提示词;道具的戏剧功能、状态变体、尺度参照、白底无手提示词。

    4.3k GitHub stars~1.1k tokensUpdated today
    Writing & ContentAuto-check: notes
  • Sepia

    Nanako0129/sepia

    Make AI-generated writing read as human-written, in fiction and in professional prose.

    3k GitHub stars~3.6k tokensUpdated 2 days ago
    Writing & ContentAuto-check passed
  • Story Toolbox Router

    zenstory-ai/oh-story-claudecode

    Routes a Chinese web-novel writing request to the matching tool in a 13-skill toolbox, covers author habit memory, and can launch a local dashboard for browsing a project.

    7.4k GitHub stars~1.7k tokensUpdated 5 days ago
    Writing & ContentAuto-check passed

More from danjdewhurst/story-skills

All 24 skills in this repo
  • Story Maintenance

    danjdewhurst/story-skills

    This skill should be used when the user asks to "validate", "reindex", "repair registries", "check links", "run the continuity, pacing, clue, voice, or name checks", "count words", "summarize a…

    283 GitHub starsUsed in 1 repo~5.4k tokens
    Auto-check: notes
  • Adaptation

    danjdewhurst/story-skills

    This skill should be used when the user asks to "make an audiobook", "narration script", "narrator", "ACX", "Findaway", "pronunciation guide", "how long is the audiobook", "adapt to a screenplay"…

    283 GitHub starsUsed in 1 repo~3.5k tokens
    Auto-check: notes
  • Chapter Writing

    danjdewhurst/story-skills

    This 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…

    283 GitHub starsUsed in 1 repo~4.8k tokens
    Auto-check: notes
  • Character Management

    danjdewhurst/story-skills

    This 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…

    283 GitHub starsUsed in 1 repo~3.9k tokens
    Auto-check: notes
  • Discovery Drafting

    danjdewhurst/story-skills

    This skill should be used when the user asks about "pantsing", "discovery write", "write without an outline", "discovery draft", "write into the dark", "story kernel", "reconcile a chapter", "dead…

    283 GitHub starsUsed in 1 repo~2k tokens
    Auto-check: notes
  • Editorial Review

    danjdewhurst/story-skills

    This skill should be used when the user asks for a "sensitivity reader", "authenticity reader", "cultural review", "is this portrayal okay", "real people in my novel", "defamation", "can I use song…

    283 GitHub starsUsed in 1 repo~3.6k tokens
    Auto-check: notes

Questions about Scene Craft

What does Scene Craft do?

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…. Scene Craft is an agent skill from danjdewhurst/story-skills. 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", "scene outcome", "yes-but no-and", "chapter hook", or wants scene-level craft for drafting or revision.

When should I use Scene Craft?

Scene Craft fits situations like: asks to plan a scene; scene structure; dialogue subtext; psychic distance.

How do I install Scene Craft in Claude Code?

Run `npx skills add danjdewhurst/story-skills --skill scene-craft -a claude-code`. Or copy the skill folder (skills/scene-craft in danjdewhurst/story-skills) into .claude/skills/scene-craft in your project. Claude Code loads it when a task matches its description.

How do I install Scene Craft in Codex?

Run `npx skills add danjdewhurst/story-skills --skill scene-craft -a codex`. Or copy the skill folder (skills/scene-craft in danjdewhurst/story-skills) into .agents/skills/scene-craft in your project. Codex loads it when a task matches its description.

Can I use Scene Craft in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add danjdewhurst/story-skills --skill scene-craft -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/scene-craft, .gemini/skills/scene-craft, .github/skills/scene-craft and .opencode/skills/scene-craft in your project.

What does Scene Craft need to run?

Going by SKILL.md and its folder, Scene Craft needs the command-line tools its instructions call (node).

Does Scene Craft access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Scene Craft safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Scene Craft use?

Scene Craft is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Scene Craft use?

About 2.3k tokens (SKILL.md is roughly 9.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 7.1k tokens, read only when the agent opens those files.

What are the alternatives to Scene Craft?

Skills that share tags, products or a category with Scene Craft: Story Multi-Perspective Review (zenstory-ai/oh-story-claudecode, 7.4k stars), Short Web Fiction Trend Scan (zenstory-ai/oh-story-claudecode, 7.4k stars), InkOS Creative Harness (Narcooo/inkos, 10k stars) and Novel Art (eternityspring/shuohao-skills, 4.3k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Scene Craft?

danjdewhurst (a GitHub user) maintains it in danjdewhurst/story-skills, which has 283 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on October 8, 2026.

Source: danjdewhurst/story-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.