All skills
danjdewhurst avatar

/discovery-drafting

@e6e1248
by Daniel Dewhurstdanjdewhurst/story-skills254 stars
39

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.

Use this Skill: https://skilld.dev/gh/danjdewhurst/story-skills/discovery-drafting

This session only. Nothing lands on disk.

SKILL.md

โ‰ˆ93 tokens always: the name and description. โ‰ˆ1.4k when used: this file. โ‰ˆ3.6k more on demand in 4 files.

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. Create the chapter with story add chapter "Title" --number N --mode discovered so story next flags it until it is reconciled (in a draft-mode: discovered project a drafted chapter with no mode is flagged too). 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
    • Add post-hoc chapter notes above ## Chapter Text (below it they count and ship as prose); 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 โ€” story next lists any without post-hoc notes under Reconcile discovered chapters; finish those, 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, above ## Chapter Text, 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

Source: SKILL.md on GitHub

No alerts3d3 checks ยท Risk SAFE
  • Gen Agent Trust Hub3d

    This skill implements a discovery drafting workflow for writers, allowing for prose creation without an upfront outline. It includes processes for reconciling new story elements back into a central story bible through entity extraction and reverse-outlining. The skill utilizes a custom CLI tool for project maintenance tasks like indexing and validation. Security-wise, it presents a standard indirect prompt injection surface due to its analysis of user-provided prose, but mitigates this with required user-approval steps for all changes.

  • Socket3d

    No alerts

  • Snyk3d

    Risk: LOW ยท No issues

Signed by skilld at e6e1248. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 18 hours ago.

Activeupdated 4 days ago

README badge

README badge for danjdewhurst/story-skills/discovery-drafting