Skip to main content
skill CX Codex

chapter-architect — Claude Code skill: chapter planning

This skill turns a high-level chapter brief into a beat-level outline. It helps shape the reader’s journey before drafting while leaving room for author decisions.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add robertguss/claude-code-toolkit --skill chapter-architect -a claude-code
Open on GitHub

What chapter-architect does

chapter-architect takes a chapter specification from an Architecture Document and develops it into a sequence of beats. It tracks the chapter’s job, the reader’s starting and ending states, key concepts, links to nearby chapters, and the emotional movement through the material. Each beat records its purpose, suggested material, reader destination, and whether it carries the structure.

The workflow gathers an Architecture Document, Research Dossier, Book Concept Document, and author notes, then moves through orientation, beat brainstorming, sequencing, detailed review, and final approval. Reference files cover chapter types, emotional arcs, opening and closing strategies, beat vocabulary, and common chapter problems; the result follows assets/templates/chapter-outline-template.md. The Architecture Document is required because it supplies the chapter’s purpose and boundaries.

What it helps with

  • turn a chapter brief into beat-level structure
  • sequence ideas around the reader’s changing state
  • track intellectual and emotional movement
  • connect one chapter to the next
  • prepare a handoff for draft-coach or ghostwriter

Example prompts for the agent

  • Turn the chapter specification in the Architecture Document into a Chapter Outline Document.
  • Generate candidate beats, debate their order, and mark which beats are load-bearing.
  • Review this outline against the reader’s entry and exit states, then prepare it for the ghostwriter.

How to install chapter-architect

1Skills CLI (Vercel)

npx skills add robertguss/claude-code-toolkit --skill chapter-architect -a claude-code

2Manually: put the files in place

~/.claude/skills/chapter-architect/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/chapter-architect/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about chapter-architect

How do I install chapter-architect in Claude Code?

Run npx skills add robertguss/claude-code-toolkit --skill chapter-architect -a claude-code. The skill file will be available at ~/.claude/skills/chapter-architect/SKILL.md.

What does chapter-architect do?

It develops a high-level chapter specification into a beat-level outline. The skill supports idea generation, sequencing, reader-journey checks, and preparation of a Chapter Outline Document.

What does chapter-architect need to work?

It works from an Architecture Document, Research Dossier, Book Concept Document, and author notes. A continuing session also needs the latest working draft.

Similar skills

All skills for Writing and docs →

From the same set18

every-style-editor This skill audits articles, newsletters, and blog posts against Every's writing standards. It reviews copy line by line to catch grammar issues and formatting slips. CX Codex +1 ★ 132repo stars dhh-writing This skill guides an agent toward bold, direct prose for articles, business writing, and manifestos. Use it when a draft needs a clear stance and concrete arguments. CX Codex +1 ★ 132repo stars writing-dna-discovery A skill that interviews you and reads your samples to build a voice document a ghost writer skill can follow. CX Codex +1 ★ 132repo stars ghost-writer Creates two distinct first drafts matching personal writing style from a Voice DNA Document. Useful for crafting articles and newsletters. CX Codex +1 ★ 132repo stars book-research-assistant A skill that plans and vets research for a nonfiction book: turns fact gaps into questions, writes the prompts, and rules on each source. CX Codex +1 ★ 132repo stars book-market-research Evaluates the commercial potential of nonfiction book ideas for Amazon KDP publishing. Clarifies market demand and rivals before you start drafting. CX Codex +1 ★ 132repo stars book-ideation Develop a nonfiction book idea into a structured concept, clarifying its reader, central claim, and promise. Use it before validating the idea or planning the book. CX Codex +1 ★ 132repo stars book-idea-validator Stress-tests a nonfiction book concept against existing research. Tells you whether the thesis holds up before you write. CX Codex +1 ★ 132repo stars

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor