mcpbeat Sign in

Chapter Architect Skill for Claude

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.

20k tokens
context cost
the whole folder, loaded on every use
8
files
instructions only
0
copies elsewhere
how many repositories repackaged it
102
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/robertguss/claude-code-toolkit --skill chapter-architect

What comes with it

70 465 bytes besides the instruction
assets/templates/chapter-outline-template.md
references/beat-vocabulary.md
references/closing-strategies.md
references/common-chapter-problems.md
references/emotional-arc-patterns.md
references/opening-strategies.md
references/special-chapter-types.md

The instruction itself

14 sections, as written by the author

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

  • Reader-first, always. Every beat exists to move the reader toward the

chapter's destination—intellectually and emotionally.

  • Compass, not GPS. The outline points direction and marks waypoints. It

does not dictate every turn. The ghostwriter has creative freedom within the

structure.

  • Collaborative partnership. Claude contributes ideas, challenges weak

thinking, and advocates for what serves the reader. The author has final

approval on all decisions.

  • Intent over prescription. Each beat captures _why_ it exists, not just

_what_ it contains. This enables intelligent adaptation during drafting.

  • 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

  • Identify context:
  • New chapter or continuing a previous session?
  • If continuing, request the latest working draft.
  • Gather inputs:
  • Architecture Document (chapter specification)
  • Research Dossier (chapter's section)
  • Book Concept Document (reader, promise, voice)
  • Any author notes on this chapter
  • 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:

  • Review the beat vocabulary together
  • _Read references/beat-vocabulary.md_
  • Generate possible beats—both author and Claude contribute
  • Consider opening options
  • _Reference references/opening-strategies.md_
  • Consider closing options
  • _Reference references/closing-strategies.md_
  • 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:

  • Propose an initial sequence
  • Walk through the reader's experience: "They arrive here, then this happens,

now they feel..."

  • 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?
  • Identify which beats are load-bearing (structural, can't move) vs. flexible
  • Cut beats that aren't earning their place
  • 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:

  • Claude walks through the reader's experience aloud—beat by beat, tracking

intellectual and emotional state

  • Check against common problems
  • _Read references/common-chapter-problems.md_
  • Verify the chapter delivers on its job and reaches the exit state
  • Confirm the bridge to the next chapter works
  • Final author approval

Only after approval: Produce the Chapter Outline Document using the

template.

  • _Use assets/templates/chapter-outline-template.md_

Session End

  • Produce the versioned Chapter Outline Document (v1, v2, etc.)
  • Summarize any open questions or flags for the ghostwriter
  • Confirm next steps:
  • Ready for drafting? → Handoff to draft-coach or ghostwriter
  • Need another session? → Note where to resume

Inputs

| Document | Source | Purpose |

| --------------------- | -------------------- | ------------------------------------------------------- |

| Architecture Document | book-architect | Chapter's job, entry/exit states, key concepts, bridges |

| Research Dossier | research-assistant | Evidence, examples, quotes organized by chapter |

| Book Concept Document | book-ideation | Reader, promise, thesis, voice, author angle |

| Author notes | Author | Any existing thoughts, fragments, or constraints |

Outputs

Chapter Outline Document containing:

  • Chapter Context (job, entry/exit states, connections, emotional arc, tone

notes)

  • Reader Journey Walkthrough (prose narrative of the experience)
  • Beat Sequence (detailed breakdown of each beat)
  • Opening and Closing Deep Dives (expanded treatment)

See assets/templates/chapter-outline-template.md for exact format.

Readiness Criteria

Before handoff, confirm:

  • [ ] All beats have clear reader destinations (intellectual and emotional)
  • [ ] Load-bearing beats are flagged
  • [ ] Key material is curated and pointed to for each beat
  • [ ] Opening and closing have deep-dive treatment
  • [ ] Reader journey walkthrough captures the chapter's feel
  • [ ] The chapter delivers on its job and exit state
  • [ ] Bridge to next chapter is clear
  • [ ] Author has approved the outline

Handoff

The Chapter Outline Document feeds into:

  • draft-coach — if author is writing and wants feedback
  • ghostwriter (modal) — if Claude is drafting and author approves

The ghostwriter also receives the full Research Dossier for the chapter, with

the outline's key material pointers as primary guidance.

Other skills for the same job

different authors, same section of the catalogue
DOCX
by anthropics
vendor ×16

Comprehensive document creation, editing, and analysis with support for tracked changes, comments, formatting preservation, and text extraction. When Claude needs to work with professional documents (.docx files) for: (1) Creating new documents, (2) Modifying or editing content, (3) Working with tracked changes, (4) Adding comments, or any other document tasks

7k tokens
PDF
by anthropics
vendor ×16

Comprehensive PDF manipulation toolkit for extracting text and tables, creating new PDFs, merging/splitting documents, and handling forms. When Claude needs to fill in a PDF form or programmatically process, generate, or analyze PDF documents at scale.

13k tokens scripts
PPTX
by JayZeeDesign
×15

Presentation creation, editing, and analysis. When Claude needs to work with presentations (.pptx files) for: (1) Creating new presentations, (2) Modifying or editing content, (3) Working with layouts, (4) Adding comments or speaker notes, or any other presentation tasks

308k tokens scripts
Canvas Design
by anthropics
vendor ×13

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

1388k tokens
PDF
by anthropics
vendor ×10

Use this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill.

15k tokens scripts
DOCX
by w95
×6

Use this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation.

5k tokens
PPTX
by w95
×4

Use this skill any time a .pptx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates, layouts, speaker notes, or comments. Trigger whenever the user mentions \"deck,\" \"slides,\" \"presentation,\" or references a .pptx filename, regardless of what they plan to do with the content afterward. If a .pptx file needs to be opened, created, or touched, use this skill.

2k tokens
Obsidian Markdown
by ZhanlinCui
×3

Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax. Use when working with .md files in Obsidian, or when the user mentions wikilinks, callouts, frontmatter, tags, embeds, or Obsidian notes.

3k tokens

How to use it

Copy the folder

Take robertguss/chapter-architect from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.