chapter-writing
npx machina-cli add skill danjdewhurst/story-skills/chapter-writing --openclawChapter Writing
Overview
Write story chapters using an outline-first workflow. Gathers context from all other story elements (characters, world, plot) to maintain consistency, builds a beat-by-beat outline for approval, then writes full prose. After writing, updates all cross-references (chapter index, timeline, foreshadowing).
Prerequisites
A story project must already exist with at least:
story.md(story bible)- At least one character in
characters/ - A plot structure in
plot/_index.md(recommended but not required for first chapters)
Outline-First Workflow
1. Gather Context
Read these files to understand the current story state:
story.md- genre, themes, POV, tensechapters/_index.md- what's been written, current word countplot/_index.md- arc status, what needs to happen nextplot/timeline.md- chronological position
If this isn't the first chapter, also read:
- The previous chapter file - for continuity (ending state, cliffhangers, emotional tone)
- Active arc files in
plot/arcs/- for upcoming plot beats
2. Determine Chapter Scope
Ask the user:
- What should this chapter cover? (or suggest based on plot arcs)
- Whose POV?
- Which location(s)?
If plot arcs exist, suggest the next logical beats to advance.
3. Build the Outline
Create a beat-by-beat outline listing:
- Each scene/beat and what it accomplishes
- POV character and location for each beat
- Which arc plot points are advanced
- Any foreshadowing to plant or pay off
Load the POV character's file for voice reference. Load relevant location files for setting details.
Present the outline to the user for approval. Revise until approved.
4. Write the Chapter
With the approved outline, write the full prose:
- Follow the POV and tense from
story.md - Use the POV character's voice and speech patterns from their profile
- Ground scenes in location details from worldbuilding files
- Consult
references/writing-guidelines.mdfor prose craft guidance - Use the chapter template from
references/chapter-template.md - Include the approved outline in the file above the prose (for reference)
Save to chapters/chapter-{NN}.md with appropriate frontmatter.
5. Post-Write Updates
After the chapter is written:
- Update
chapters/_index.md- add chapter to registry, update total word count - Update
plot/timeline.md- add events from this chapter in chronological order - Update arc files - mark advanced plot points with chapter reference
- Update foreshadowing - mark any items as
plantedorpaid-offwith chapter reference - Note character changes - if a character's status changed (injury, revelation, relationship shift), flag for the user to update the character file
Present a summary of all updates made.
Scene Breaks
Within a chapter, separate scenes with ---. Each scene should have a clear POV character (even if the same as the previous scene) and location.
Revision Workflow
When asked to revise a chapter:
- Read the existing chapter
- Understand what needs to change
- Make targeted edits rather than rewriting from scratch
- Update word count in frontmatter
- Update chapter status (draft -> revised)
Reference Files
references/chapter-template.md- Frontmatter and structure template for chapter filesreferences/writing-guidelines.md- Prose craft guidance: show-don't-tell, POV, dialogue, pacing, scene structure, continuity
Source
git clone https://github.com/danjdewhurst/story-skills/blob/main/skills/chapter-writing/SKILL.mdView on GitHub Overview
Chapter Writing follows an outline-first workflow to keep story elements aligned. It gathers context from the story bible, character and plot files, builds a beat-by-beat outline for approval, then writes full prose and updates cross-references such as the chapter index and timeline.
How This Skill Works
The system reads story.md, chapters/_index.md, plot/_index.md, and plot/timeline.md to determine POV, tense, and pacing. It then creates a beat-by-beat outline with scene goals and locations, presents it for user approval, and, once approved, writes the full prose using the POV voice and location details, guided by the chapter-template.md and writing-guidelines.md. After writing, it saves the chapter file and updates chapters/_index.md, plot/timeline.md, arc points, foreshadowing, and character changes references.
When to Use It
- You want to write the next chapter in a story project with established world, characters, and plot.
- You need a chapter outline before drafting full prose to ensure continuity.
- You’re continuing a story from a previous chapter and must align POV, tone, and timing.
- You’re drafting a scene or prose that requires a specific POV and location grounded in worldbuilding files.
- You want to revise or update a chapter and refresh related timelines and foreshadowing.
Quick Start
- Step 1: Gather context from story.md, chapters/_index.md, plot/_index.md, and plot/timeline.md.
- Step 2: Build a beat-by-beat outline, select POV, location, and get user approval.
- Step 3: Write the chapter using the approved outline, save to chapters/chapter-{NN}.md, and perform post-write updates.
Best Practices
- Start with a beat-by-beat outline and keep the approved outline visible above the prose.
- Follow the POV and tense defined in story.md and mimic the voice from the POV character’s profile.
- Ground scenes with location details from worldbuilding files; consult writing guidelines for craft.
- Use the chapter-template.md as the structural baseline for every chapter file.
- After writing, update chapters/_index.md, plot/timeline.md, arcs, and foreshadowing to reflect new content.
Example Use Cases
- Drafting the next chapter of a fantasy epic with a consistent alternate-POV structure.
- Creating an outline for a thriller chapter before writing the full scene.
- Continuing a romance with a shift in POV while preserving voice and pacing.
- Writing a high-stakes action scene in a sci-fi world using precise worldbuilding.
- Revising a chapter after a plot twist and updating the timeline and foreshadowing.