Discovery drafting

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

How to use it

Claude Code
  1. Run the line below. It pulls the whole folder into ~/.claude/skills/discovery-drafting, including the files SKILL.md points to.
  2. Describe your job in plain words. Claude Code follows the skill from there.
Claude Code — installs the whole folder, not just SKILL.md
npx degit danjdewhurst/story-skills/skills/discovery-drafting#main ~/.claude/skills/discovery-drafting

For one project only, change the path to .claude/skills/discovery-drafting. This skill also uses story.md, style-sheet.md — copying SKILL.md alone won't be enough. See the folder on GitHub.

Claude (web or desktop app)
  1. On this page open ⋯ → Download .md.
  2. Save it as SKILL.md in a folder, zip the folder, then Customize → Skills → + → Create skill → Upload a skill.
  3. Pick the file and Save. Claude shows the name and description and runs a security scan.
  4. Check the skill is switched on.
  5. Start a new chat and describe your job in plain words. The AI follows the skill from there.
ChatGPT or another app
  1. ChatGPT: make a Project and paste it into Instructions.
  2. Neither? Paste it at the top of a new chat — it works for that chat.
Not working?
  • Check which app you pasted it into — the steps above name the right one.
  • Some skills need the paid tier of Claude or ChatGPT.
Step-by-step guide with screenshots · Ask in the forum

Paste into Claude, ChatGPT or Cursor.

Source of Discovery drafting

Show the full text106 lines
namedescription
discovery-draftingThis 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.

Discovery Drafting

Overview

Draft by discovery ("pantsing"): start from a one-paragraph story kernel rather than a beat sheet, write forward, then reconcile each chapter back into the story bible through a structured loop (extract entities → reverse outline → diff against the bible → reconcile). This is the complement to chapter-writing's outline-first workflow. The bible is maintained after the prose, not before — which the repo's import-style entity extraction and continuity checks already support.

Prerequisites

A story project must already exist (created via the story-init skill), with at least a story.md and one character. No plot structure is required to start — arcs get built during reconciliation.

When to Use

  • The user wants to draft without outlining first, or identifies as a discovery writer
  • Starting a project from a situation/character rather than a plot
  • NOT for mysteries or other clue-dependent genres where setup must precede payoff (use chapter-writing; see genre-craft)
  • NOT for revising existing chapters (use revision-continuity)
  • The user can switch modes per project or per chapter; record the mode so audits know which discipline applies

Workflow

  1. Write the story kernel. Consult references/story-kernel.md and draft the one-paragraph kernel with the user (character in a situation, a want, an obstacle, a tone signal). Store it in story.md under ## Story Kernel and set draft-mode: discovered in frontmatter.
  2. Draft forward. Write the chapter from the kernel using the session shape in references/drafting-cadence.md (re-read → write → close with a next-session note). Write forward only; park bible questions as [TODO: check bible] inline rather than stopping. Follow the prose craft in chapter-writing/references/writing-guidelines.md and the scene-grain tools in the scene-craft skill as usual, and write in the voice and house style recorded in style-sheet.md — discovery changes planning order, not prose standards.
  3. Run the reconcile loop. After each chapter, follow references/reconcile-loop.md exactly:
    • Extract new entity/promise candidates (import-style, user-approved)
    • Reverse-outline the chapter into the chapter file and scenes/ records
    • Diff against the bible (new / contradiction / enrichment / dangling)
    • Reconcile: update the bible or revise the chapter — never neither
    • Append post-hoc chapter notes; set chapter frontmatter mode: discovered
  4. Batch review every 3–5 chapters. Re-read post-hoc notes, sweep the promise/question ledgers for dangling setups, and cut dead ends per references/dead-ends.md (abandoned ledger entries keep a recorded reason; cut characters get status: cut, not deletion).
  5. Hold the cadence. Keep the agreed target (see references/drafting-cadence.md) and log each session with story progress . --log; at midpoint and draft completion, hand the batch to revision-continuity for developmental checks before continuing.
  6. Close the loop on mode. When the draft is complete, every mode: discovered chapter must have post-hoc notes and a completed diff — flag any that don't as unfinished maintenance, then hand the manuscript to revision-continuity for revision passes.

Conventions

  • story.md frontmatter draft-mode: discovered marks a discovery project; per-chapter mode: discovered / mode: outlined tracks mixed projects.
  • Chapters carry a ## Chapter Notes (post-hoc) section recording what was discovered, what was cut, and open questions — the project's memory of why the bible looks the way it does.
  • Entity candidates extracted from prose are presented for user approval before bible files are created (same discipline as story import).
  • Cut threads are logged, not erased: abandoned promises/questions keep status: abandoned with a reason; cut characters keep their file with status: cut.
  • Bidirectional links and kebab-case ids follow the story-init conventions exactly — discovery changes when the bible is written, not how.

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 each reconcile loop:

story wordcount . --write
story reindex .
story links .
story validate .
story continuity .

Reference Files

  • references/story-kernel.md - The one-paragraph kernel: character in a situation, want, obstacle, tone signal
  • references/reconcile-loop.md - The core loop: extract entities/promises → reverse-outline → diff against the bible → reconcile; mode: discovered flag
  • references/dead-ends.md - Recognizing and cutting dead ends: cut/fold/prune, abandoned ledger entries, the darling log
  • references/drafting-cadence.md - Daily targets, batch reviews, session shape, recovering a broken cadence
1---
2name: discovery-drafting
3description: This 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.
4---
5 
6# Discovery Drafting
7 
8## Overview
9 
10Draft by discovery ("pantsing"): start from a one-paragraph story kernel
11rather than a beat sheet, write forward, then reconcile each chapter back
12into the story bible through a structured loop (extract entities → reverse
13outline → diff against the bible → reconcile). This is the complement to
14chapter-writing's outline-first workflow. The bible is maintained *after*
15the prose, not before — which the repo's import-style entity extraction and
16continuity checks already support.
17 
18## Prerequisites
19 
20A story project must already exist (created via the story-init skill), with
21at least a `story.md` and one character. No plot structure is required to
22start — arcs get built during reconciliation.
23 
24## When to Use
25 
26- The user wants to draft without outlining first, or identifies as a
27 discovery writer
28- Starting a project from a situation/character rather than a plot
29- NOT for mysteries or other clue-dependent genres where setup must precede
30 payoff (use chapter-writing; see `genre-craft`)
31- NOT for revising existing chapters (use `revision-continuity`)
32- The user can switch modes per project or per chapter; record the mode so
33 audits know which discipline applies
34 
35## Workflow
36 
371. **Write the story kernel.** Consult `references/story-kernel.md` and
38 draft the one-paragraph kernel with the user (character in a situation,
39 a want, an obstacle, a tone signal). Store it in `story.md` under
40 `## Story Kernel` and set `draft-mode: discovered` in frontmatter.
412. **Draft forward.** Write the chapter from the kernel using the session
42 shape in `references/drafting-cadence.md` (re-read → write → close with
43 a next-session note). Write forward only; park bible questions as
44 `[TODO: check bible]` inline rather than stopping. Follow the prose
45 craft in `chapter-writing/references/writing-guidelines.md` and the
46 scene-grain tools in the `scene-craft` skill as usual, and write in the
47 voice and house style recorded in `style-sheet.md` — discovery changes
48 *planning order*, not prose standards.
493. **Run the reconcile loop.** After each chapter, follow
50 `references/reconcile-loop.md` exactly:
51 - Extract new entity/promise candidates (import-style, user-approved)
52 - Reverse-outline the chapter into the chapter file and `scenes/` records
53 - Diff against the bible (new / contradiction / enrichment / dangling)
54 - Reconcile: update the bible **or** revise the chapter — never neither
55 - Append post-hoc chapter notes; set chapter frontmatter
56 `mode: discovered`
574. **Batch review every 3–5 chapters.** Re-read post-hoc notes, sweep the
58 promise/question ledgers for dangling setups, and cut dead ends per
59 `references/dead-ends.md` (abandoned ledger entries keep a recorded
60 reason; cut characters get `status: cut`, not deletion).
615. **Hold the cadence.** Keep the agreed target (see
62 `references/drafting-cadence.md`) and log each session with
63 `story progress . --log`; at midpoint and draft completion,
64 hand the batch to `revision-continuity` for developmental checks before
65 continuing.
666. **Close the loop on mode.** When the draft is complete, every
67 `mode: discovered` chapter must have post-hoc notes and a completed
68 diff — flag any that don't as unfinished maintenance, then hand the
69 manuscript to `revision-continuity` for revision passes.
70 
71## Conventions
72 
73- `story.md` frontmatter `draft-mode: discovered` marks a discovery project;
74 per-chapter `mode: discovered` / `mode: outlined` tracks mixed projects.
75- Chapters carry a `## Chapter Notes (post-hoc)` section recording what was
76 discovered, what was cut, and open questions — the project's memory of
77 why the bible looks the way it does.
78- Entity candidates extracted from prose are presented for user approval
79 before bible files are created (same discipline as `story import`).
80- Cut threads are logged, not erased: abandoned promises/questions keep
81 `status: abandoned` with a reason; cut characters keep their file with
82 `status: cut`.
83- Bidirectional links and kebab-case ids follow the story-init conventions
84 exactly — discovery changes when the bible is written, not how.
85 
86## CLI Maintenance
87 
88Use 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.
89 
90After each reconcile loop:
91 
92```shell
93story wordcount . --write
94story reindex .
95story links .
96story validate .
97story continuity .
98```
99 
100## Reference Files
101 
102- **`references/story-kernel.md`** - The one-paragraph kernel: character in a situation, want, obstacle, tone signal
103- **`references/reconcile-loop.md`** - The core loop: extract entities/promises → reverse-outline → diff against the bible → reconcile; `mode: discovered` flag
104- **`references/dead-ends.md`** - Recognizing and cutting dead ends: cut/fold/prune, abandoned ledger entries, the darling log
105- **`references/drafting-cadence.md`** - Daily targets, batch reviews, session shape, recovering a broken cadence
106 

Discussion