/chapter-architect
Transform a chapter's high-level specification (from book-architect) into a beat-level outline that guides drafting while preserving creative freedom.
Claude Code
$ npx -y skills add robertguss/claude-code-toolkit --skill chapter-architect --agent claude-code
Codex
$ npx skills add robertguss/claude-code-toolkit --skill chapter-architect -a codex -y
Cursor
$ npx skills add robertguss/claude-code-toolkit --skill chapter-architect -a cursor -y
Gemini CLI
$ npx skills add robertguss/claude-code-toolkit --skill chapter-architect -a gemini-cli -y
GitHub Copilot
$ npx skills add robertguss/claude-code-toolkit --skill chapter-architect -a github-copilot -y
OpenCode
$ npx skills add robertguss/claude-code-toolkit --skill chapter-architect -a opencode -y
Windsurf
$ npx skills add robertguss/claude-code-toolkit --skill chapter-architect -a windsurf -y
SKILL.md
chapter-architect.SKILL.mdname: chapter-architect
license: Proprietary
metadata:
author: robertguss
version: "1.0"
description:
Plan and architect a single chapter at beat-level granularity. Use when you
have a chapter from the Architecture Document and need to create a detailed
outline before drafting. Produces a Chapter Outline Document for use by
draft-coach or ghostwriter.
Chapter Architect
Transform a chapter's high-level specification (from book-architect) into a beat-level outline that guides drafting while preserving creative freedom.
Core Philosophy
1. **Reader-first, always.** Every beat exists to move the reader toward the chapter's destination—intellectually and emotionally.
2. **Compass, not GPS.** The outline points direction and marks waypoints. It does not dictate every turn. The ghostwriter has creative freedom within the structure.
3. **Collaborative partnership.** Claude contributes ideas, challenges weak thinking, and advocates for what serves the reader. The author has final approval on all decisions.
4. **Intent over prescription.** Each beat captures _why_ it exists, not just _what_ it contains. This enables intelligent adaptation during drafting.
5. **Emotional arc matters.** Track not just where the reader is intellectually, but how they _feel_ at each stage of the journey.
Session Flow
This skill is session-flexible. Simple chapters may complete in one session. Complex chapters may need natural pause points with thinking time between.
Session Start
1. **Identify context:**
- New chapter or continuing a previous session?
- If continuing, request the latest working draft.
2. **Gather inputs:**
- Architecture Document (chapter specification)
- Research Dossier (chapter's section)
- Book Concept Document (reader, promise, voice)
- Any author notes on this chapter
3. **Confirm which chapter** we're architecting and surface the key specs:
- Chapter number and working title
- Chapter's job
- Reader entry state
- Reader exit state
- Key concepts to cover
- Bridge from previous / to next chapter
Phase 1: Orient
Review inputs together. Surface any tensions, questions, or issues.
**Key questions to explore:**
- Is this a standard chapter or special type? (introduction, conclusion,
case-study, etc.)
- _If special type, read `references/special-chapter-types.md`_
- Is the research sufficient? Any gaps?
- Are there competing ways to approach this chapter?
- What's the emotional shape of this chapter? (tension→release,
confusion→clarity, etc.)
- _Reference `references/emotional-arc-patterns.md` as needed_
**Claude's role:** Surface concerns, ask probing questions, identify what's unclear or underdeveloped.
**Pause point:** If significant unresolved questions emerge, pause here to resolve them before proceeding.
Phase 2: Brainstorm Beats
Generate candidate beats without worrying about sequence yet.
**Process:**
1. Review the beat vocabulary together
- _Read `references/beat-vocabulary.md`_
2. Generate possible beats—both author and Claude contribute 3. Consider opening options
- _Reference `references/opening-strategies.md`_
4. Consider closing options
- _Reference `references/closing-strategies.md`_
5. Capture all candidates without judging yet
**Claude's role:** Actively contribute beat ideas, not just record. Suggest moves the author might not have considered. Ask "what about a beat that does X?"
Phase 3: Sequence and Debate
Put the beats in order. This is where real collaboration happens.
**Process:**
1. Propose an initial sequence 2. Walk through the reader's experience: "They arrive here, then this happens, now they feel..." 3. Debate ordering decisions:
- Does the counterargument come before or after the main case?
- Where does the reader need relief or breathing room?
- What must be established before something else can land?
4. Identify which beats are load-bearing (structural, can't move) vs. flexible 5. Cut beats that aren't earning their place 6. Add beats if gaps emerge
**Claude's role:** Advocate for what serves the reader. Push back when a sequence feels off. Offer alternatives with reasoning.
**Pause point:** If the sequence isn't clicking, pause here. Complex chapters may need marinating time.
Phase 4: Flesh Out Beats
For each beat in the final sequence, define:
- **Beat name and type** (from vocabulary)
- **What happens** (loosely described—compass, not GPS)
- **Reader destination** (intellectual and emotional—this is non-negotiable)
- **Key material** (specific pointers to research, quotes, examples)
- **Load-bearing flag** (yes/no—can this beat be moved or cut?)
- **Notes** (anything the ghostwriter should know)
**Special attention:** Opening and closing beats get deeper treatment.
- _Reference `references/opening-strategies.md` and
`references/closing-strategies.md`_
- Articulate _why_ this opening/closing works
- Note what to avoid
- Identify specific hooks, callbacks, or images to consider
Phase 5: Review and Finalize
Stress-test the complete arc before producing the document.
**Process:**
1. Claude walks through the reader's experience aloud—beat by beat, tracking intellectual and emotional state 2. Check against common problems
- _Read `references/common-chapter-problems.md`_
3. Verify the chapter delivers on its job and reaches the exit state 4. Confirm the bridge to the next chapter works 5. Final author approval
**Only after approval:** Produce the Chapter Outline Document using the template.
- _Use `assets/templates/chapter-outline-template.md`_
Session End
1. Produce the versioned Chapter Outline Document (v1, v2, etc.) 2. Summarize any open questions or flags for the ghostwriter 3. Confirm next steps:
- Ready for drafting? → Handoff to draft-coach or ghostwriter
- Need another session? → Note where to resume
Inputs
| Document | Source | Purpose
Read more
name: chapter-architect license: Proprietary metadata: author: robertguss version: "1.0" description: Plan and architect a single chapter at beat-level granularity. Use when you have a chapter from the Architecture Document and need to create a detailed outline before drafting. Produces a Chapter Outline Document for use by draft-coach or ghostwriter.
Chapter Architect
Transform a chapter's high-level specification (from book-architect) into a beat-level outline that guides drafting while preserving creative freedom.
Core Philosophy
1. **Reader-first, always.** Every beat exists to move the reader toward the chapter's destination—intellectually and emotionally.
2. **Compass, not GPS.** The outline points direction and marks waypoints. It does not dictate every turn. The ghostwriter has creative freedom within the structure.
3. **Collaborative partnership.** Claude contributes ideas, challenges weak thinking, and advocates for what serves the reader. The author has final approval on all decisions.
4. **Intent over prescription.** Each beat captures _why_ it exists, not just _what_ it contains. This enables intelligent adaptation during drafting.
5. **Emotional arc matters.** Track not just where the reader is intellectually, but how they _feel_ at each stage of the journey.
Session Flow
This skill is session-flexible. Simple chapters may complete in one session. Complex chapters may need natural pause points with thinking time between.
Session Start
1. **Identify context:**
- New chapter or continuing a previous session?
- If continuing, request the latest working draft.
2. **Gather inputs:**
- Architecture Document (chapter specification)
- Research Dossier (chapter's section)
- Book Concept Document (reader, promise, voice)
- Any author notes on this chapter
3. **Confirm which chapter** we're architecting and surface the key specs:
- Chapter number and working title
- Chapter's job
- Reader entry state
- Reader exit state
- Key concepts to cover
- Bridge from previous / to next chapter
Phase 1: Orient
Review inputs together. Surface any tensions, questions, or issues.
**Key questions to explore:**
- Is this a standard chapter or special type? (introduction, conclusion,
case-study, etc.)
- _If special type, read `references/special-chapter-types.md`_
- Is the research sufficient? Any gaps?
- Are there competing ways to approach this chapter?
- What's the emotional shape of this chapter? (tension→release,
confusion→clarity, etc.)
- _Reference `references/emotional-arc-patterns.md` as needed_
**Claude's role:** Surface concerns, ask probing questions, identify what's unclear or underdeveloped.
**Pause point:** If significant unresolved questions emerge, pause here to resolve them before proceeding.
Phase 2: Brainstorm Beats
Generate candidate beats without worrying about sequence yet.
**Process:**
1. Review the beat vocabulary together
- _Read `references/beat-vocabulary.md`_
2. Generate possible beats—both author and Claude contribute 3. Consider opening options
- _Reference `references/opening-strategies.md`_
4. Consider closing options
- _Reference `references/closing-strategies.md`_
5. Capture all candidates without judging yet
**Claude's role:** Actively contribute beat ideas, not just record. Suggest moves the author might not have considered. Ask "what about a beat that does X?"
Phase 3: Sequence and Debate
Put the beats in order. This is where real collaboration happens.
**Process:**
1. Propose an initial sequence 2. Walk through the reader's experience: "They arrive here, then this happens, now they feel..." 3. Debate ordering decisions:
- Does the counterargument come before or after the main case?
- Where does the reader need relief or breathing room?
- What must be established before something else can land?
4. Identify which beats are load-bearing (structural, can't move) vs. flexible 5. Cut beats that aren't earning their place 6. Add beats if gaps emerge
**Claude's role:** Advocate for what serves the reader. Push back when a sequence feels off. Offer alternatives with reasoning.
**Pause point:** If the sequence isn't clicking, pause here. Complex chapters may need marinating time.
Phase 4: Flesh Out Beats
For each beat in the final sequence, define:
- **Beat name and type** (from vocabulary)
- **What happens** (loosely described—compass, not GPS)
- **Reader destination** (intellectual and emotional—this is non-negotiable)
- **Key material** (specific pointers to research, quotes, examples)
- **Load-bearing flag** (yes/no—can this beat be moved or cut?)
- **Notes** (anything the ghostwriter should know)
**Special attention:** Opening and closing beats get deeper treatment.
- _Reference `references/opening-strategies.md` and
`references/closing-strategies.md`_
- Articulate _why_ this opening/closing works
- Note what to avoid
- Identify specific hooks, callbacks, or images to consider
Phase 5: Review and Finalize
Stress-test the complete arc before producing the document.
**Process:**
1. Claude walks through the reader's experience aloud—beat by beat, tracking intellectual and emotional state 2. Check against common problems
- _Read `references/common-chapter-problems.md`_
3. Verify the chapter delivers on its job and reaches the exit state 4. Confirm the bridge to the next chapter works 5. Final author approval
**Only after approval:** Produce the Chapter Outline Document using the template.
- _Use `assets/templates/chapter-outline-template.md`_
Session End
1. Produce the versioned Chapter Outline Document (v1, v2, etc.) 2. Summarize any open questions or flags for the ghostwriter 3. Confirm next steps:
- Ready for drafting? → Handoff to draft-coach or ghostwriter
- Need another session? → Note where to resume
Inputs
| Document | Source | Purpose
Extend Claude Code with specialized workflows, automatic formatting, and better defaults. Skills give Claude domain expertise—brainstorming methods, leading a project with worker agents, project wikis, book writing pipelines.
Other skills on claude-code-toolkit.
dhh-writing
This skill should be used when writing in the distinctive style of David Heinemeier Hansson (DHH). It applies when creating blog…
every-style-editor
This skill should be used when reviewing or editing copy to ensure adherence to Every's style guide. It provides a systematic…
pragmatic-writing
This skill should be used when writing technical content in the style of Hunt/Thomas (The Pragmatic Programmer) and Joel Spolsky…
voice-capture
This skill should be used when extracting voice profiles from sample text, creating voice documentation, or matching a specific…
writing-orchestration
This skill should be used when orchestrating complex writing workflows with multiple phases. It provides two-agent orchestration…
More skills from other plugins.
prompt-lookup
Activates when the user asks about AI prompts, needs prompt templates, wants to search for prompts, or mentions prompts.chat. Use…
ppt-master
AI-driven presentation workflow for generating editable PPTX decks and slides, reconstructing page visuals, creating reusable…
morph-ppt
Use this skill when the user wants a .pptx with smooth cross-slide animation — PowerPoint Morph transitions, Keynote-style…
frontend-slides
Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to…
Questions about chapter-architect.
- Which coding agents can use chapter-architect?
- chapter-architect installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.

