adaptation
This skill should be used when the user asks to "make an audiobook", "narration script", "narrator", "ACX", "Findaway",…
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 end", "drafting sprint", "writing cadence", or wants to draft a story by discovery
Claude Code
$ npx -y skills add danjdewhurst/story-skills --skill discovery-drafting --agent claude-code
Codex
$ npx skills add danjdewhurst/story-skills --skill discovery-drafting -a codex -y
Cursor
$ npx skills add danjdewhurst/story-skills --skill discovery-drafting -a cursor -y
Gemini CLI
$ npx skills add danjdewhurst/story-skills --skill discovery-drafting -a gemini-cli -y
GitHub Copilot
$ npx skills add danjdewhurst/story-skills --skill discovery-drafting -a github-copilot -y
OpenCode
$ npx skills add danjdewhurst/story-skills --skill discovery-drafting -a opencode -y
Windsurf
$ npx skills add danjdewhurst/story-skills --skill discovery-drafting -a windsurf -y
name: discovery-drafting description: 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 end", "drafting sprint", "writing cadence", or wants to draft a story by discovery with retrospective bible reconciliation. NOT for outline-first drafting, or mysteries and other clue-dependent genres where setup must come before payoff (use chapter-writing), or a reverse outline of an existing linear draft, a subplot cut, or another revision pass on existing chapters (use revision-continuity).
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.
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.
discovery writer
payoff (use chapter-writing; see `genre-craft`)
existing linear draft or cutting a subplot as a revision pass (use `revision-continuity`). The reverse outline inside the reconcile loop, and cutting dead ends in a batch review, stay here
audits know which discipline applies
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. Write in the `language` set in `story.md` (a missing field means `en`); the craft references' word-level advice is English, so in another language keep its aims and follow the style sheet's conventions. 3. **Run the reconcile loop.** After each chapter, follow `references/reconcile-loop.md` exactly:
keeping names as the prose spells them. Ids stay ASCII kebab-case: Cyrillic and Greek names get one automatically (`Пётр` gives `petr`), and a name in a script with no transliteration table (`李明`) needs `story add character '李明' --id li-ming`, with the id agreed with the user
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.
per-chapter `mode: discovered` / `mode: outlined` tracks mixed projects.
`## 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.
before bible files are created (same discipline as `story import`).
`status: abandoned` with a reason; cut characters keep their file with `status: cut`.
exactly — discovery changes when the bible is written, not how.
Use the Story CLI when it is available. If `story` is not installed, use the bundled fall
Agent Skills for end-to-end story writing in markdown, packaged as Codex and Claude Code plugins.
This skill should be used when the user asks to "make an audiobook", "narration script", "narrator", "ACX", "Findaway",…
This skill should be used when the user asks to "write a chapter", "next chapter", "chapter outline", "draft chapter", "continue…
This skill should be used when the user asks to "create a character", "update a character", "add a character", "build a family…
This skill should be used when the user asks for a "sensitivity reader", "authenticity reader", "cultural review", "is this…
This skill should be used when the user asks to "process beta reader feedback", "alpha reader feedback", "feedback round",…
This skill should be used when the user asks about "mystery", "fair play", "clue", "red herring", "romance beats", "HEA",…
Activates when the user asks about AI prompts, needs prompt templates, wants to search for prompts, or mentions prompts.chat. Use…
AI-driven presentation workflow for generating editable PPTX decks and slides, reconstructing page visuals, creating reusable…
Use this skill when the user wants a .pptx with smooth cross-slide animation — PowerPoint Morph transitions, Keynote-style…
Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to…