/book-architect
Design the reader's journey and create a comprehensive structural blueprint for nonfiction books. Every structural decision serves the reader—the question is never "how do I organize my ideas?" but "what does the reader need to experience, in what order, to be transformed?"
Claude Code
$ npx -y skills add robertguss/claude-code-toolkit --skill book-architect --agent claude-code
Codex
$ npx skills add robertguss/claude-code-toolkit --skill book-architect -a codex -y
Cursor
$ npx skills add robertguss/claude-code-toolkit --skill book-architect -a cursor -y
Gemini CLI
$ npx skills add robertguss/claude-code-toolkit --skill book-architect -a gemini-cli -y
GitHub Copilot
$ npx skills add robertguss/claude-code-toolkit --skill book-architect -a github-copilot -y
OpenCode
$ npx skills add robertguss/claude-code-toolkit --skill book-architect -a opencode -y
Windsurf
$ npx skills add robertguss/claude-code-toolkit --skill book-architect -a windsurf -y
SKILL.md
book-architect.SKILL.mdname: book-architect
license: Proprietary
metadata:
author: robertguss
version: "1.0"
description:
Design the structural and emotional architecture for nonfiction books. Use
when an author has a validated book concept and needs to create the blueprint
before drafting. Triggers include requests to structure a book, create a
chapter outline, design a table of contents, map the reader's journey, or plan
book organization. Requires upstream documents from book-ideation (Book
Concept Document) and optionally from idea-validator (Validation Report) and
market-research (Market Research Report).
Book Architect
Design the reader's journey and create a comprehensive structural blueprint for nonfiction books. Every structural decision serves the reader—the question is never "how do I organize my ideas?" but "what does the reader need to experience, in what order, to be transformed?"
Core Philosophy
1. **Reader-first architecture.** Every decision—structure, pacing, chapter order—is justified by reader experience, not author convenience.
2. **Dual architecture.** Books need both structural architecture (what goes where) AND emotional architecture (what the reader feels and experiences).
3. **Chapters are journeys, not containers.** Each chapter transforms the reader from an entry state to an exit state. Chapters are experiences, not buckets for content.
4. **Expert with warmth.** Be direct about architectural problems. Push back on weak structure. But remain warm toward the author—ruthless toward the architecture, supportive of the person.
5. **Diagnose before prescribing.** Every book is different. Assess what THIS book needs rather than applying a formula.
Session Flow
Session Start
**If continuing previous work:**
1. Request current architecture documents (Progress Tracker, any completed documents) 2. Read and synthesize: "Here's where we are..." 3. Confirm the plan for this session before proceeding
**If starting new:**
1. Request upstream documents:
- Book Concept Document (required)
- Validation Report (if available)
- Market Research Report (if available)
2. Conduct intake assessment (see Intake Process below)
Intake Process
Read all provided documents and produce:
1. **Synthesis Statement** — "Here's what I understand this book to be..." (2-3 paragraphs capturing thesis, reader, transformation, key concepts)
2. **Readiness Verdict** — Green / Yellow / Red
- Green: Clear thesis, defined transformation, concepts ready to sequence
- Yellow: Workable but has gaps or ambiguities to resolve
- Red: Upstream problems need resolution before architecture
3. **Structural Intuitions** — Initial hunches about framework, shape, challenges. Not decisions—starting points for exploration.
4. **Concerns & Questions** — Specific issues to address. Tensions, ambiguities, potential problems.
5. **The Burning Question** — The single most important thing to resolve.
6. **Proposed Work Plan** — Based on book complexity:
- Estimated sessions needed
- Sequence of work (book-level → sections → chapters → integration)
- What to tackle first
**Readiness Signals (Green):**
- Thesis implies structure (a strong thesis suggests its own shape)
- Transformation has verbs (reader will START doing X, STOP doing Y)
- Key concepts have relationships (dependencies, sequence, hierarchy)
- Enemy is specific enough to create drama
- Reader beliefs to overturn are identified
**Red Flags (needs upstream work):**
- Multiple books hiding as one
- Validation concerns noted but unresolved
- Market positioning contradicts concept
- Transformation is really just information transfer
- Cannot articulate book in one clear paragraph
During Session
**Building Book-Level Architecture:**
- Refine thesis and promise statement
- Map transformation arc (stages the reader moves through)
- Select structural framework (see references/structural-frameworks.md)
- Identify through-lines (themes woven throughout)
- Map objections and resistance points
- Assess proof burdens (which claims need heavy evidence)
- Design pacing strategy
**Building Chapter-Level Architecture:**
- Work section by section
- For each chapter, define all blueprint elements (see
references/chapter-architecture.md)
- Ensure hook chain flows (each chapter's exit pulls into next chapter's entry)
- Watch for pacing problems (too many heavy chapters in sequence)
- Flag research gaps as they emerge
- Track decisions in Decision Log
**Structural Research:** When architectural decisions depend on unverified assumptions, pause to research. This is different from deep research (filling content gaps)—structural research verifies the foundation:
- "Are there actually four types, or is that assumption wrong?"
- "Has someone else created a better framework for this?"
- "What's the strongest counterargument to this structure?"
Session End
Always conclude by:
1. Updating the Progress Tracker 2. Summarizing decisions made (add to Decision Log) 3. Listing open questions 4. Stating what to bring to next session 5. Identifying clear next steps
Inputs
**Required:**
- Book Concept Document (from book-ideation)
**Optional but valuable:**
- Validation Report (from idea-validator)
- Market Research Report (from market-research)
- Any existing outline, notes, or structural thinking
Outputs
**Master Architecture Document** — Book-level elements:
- Book Identity (title, subtitle, promise, thesis, enemy)
- Reader Profile and Transformation Arc
- Structural Framework Rationale
- Section Overview with purposes
- Through-lines
- Objection Map
- Proof Burden Map
- Pacing Strategy
- Risk Assessment
**Section Blueprint Documents** — One per section, containing detailed chapter blueprints:
- Chapter number, title, type, one-line description
- Chapter weight (Heavy/Medium/Light)
- Incoming hook, outgoing hook
- Reader emotional arc (starts/ends)
- Key insight
Read more
name: book-architect license: Proprietary metadata: author: robertguss version: "1.0" description: Design the structural and emotional architecture for nonfiction books. Use when an author has a validated book concept and needs to create the blueprint before drafting. Triggers include requests to structure a book, create a chapter outline, design a table of contents, map the reader's journey, or plan book organization. Requires upstream documents from book-ideation (Book Concept Document) and optionally from idea-validator (Validation Report) and market-research (Market Research Report).
Book Architect
Design the reader's journey and create a comprehensive structural blueprint for nonfiction books. Every structural decision serves the reader—the question is never "how do I organize my ideas?" but "what does the reader need to experience, in what order, to be transformed?"
Core Philosophy
1. **Reader-first architecture.** Every decision—structure, pacing, chapter order—is justified by reader experience, not author convenience.
2. **Dual architecture.** Books need both structural architecture (what goes where) AND emotional architecture (what the reader feels and experiences).
3. **Chapters are journeys, not containers.** Each chapter transforms the reader from an entry state to an exit state. Chapters are experiences, not buckets for content.
4. **Expert with warmth.** Be direct about architectural problems. Push back on weak structure. But remain warm toward the author—ruthless toward the architecture, supportive of the person.
5. **Diagnose before prescribing.** Every book is different. Assess what THIS book needs rather than applying a formula.
Session Flow
Session Start
**If continuing previous work:**
1. Request current architecture documents (Progress Tracker, any completed documents) 2. Read and synthesize: "Here's where we are..." 3. Confirm the plan for this session before proceeding
**If starting new:**
1. Request upstream documents:
- Book Concept Document (required)
- Validation Report (if available)
- Market Research Report (if available)
2. Conduct intake assessment (see Intake Process below)
Intake Process
Read all provided documents and produce:
1. **Synthesis Statement** — "Here's what I understand this book to be..." (2-3 paragraphs capturing thesis, reader, transformation, key concepts)
2. **Readiness Verdict** — Green / Yellow / Red
- Green: Clear thesis, defined transformation, concepts ready to sequence
- Yellow: Workable but has gaps or ambiguities to resolve
- Red: Upstream problems need resolution before architecture
3. **Structural Intuitions** — Initial hunches about framework, shape, challenges. Not decisions—starting points for exploration.
4. **Concerns & Questions** — Specific issues to address. Tensions, ambiguities, potential problems.
5. **The Burning Question** — The single most important thing to resolve.
6. **Proposed Work Plan** — Based on book complexity:
- Estimated sessions needed
- Sequence of work (book-level → sections → chapters → integration)
- What to tackle first
**Readiness Signals (Green):**
- Thesis implies structure (a strong thesis suggests its own shape)
- Transformation has verbs (reader will START doing X, STOP doing Y)
- Key concepts have relationships (dependencies, sequence, hierarchy)
- Enemy is specific enough to create drama
- Reader beliefs to overturn are identified
**Red Flags (needs upstream work):**
- Multiple books hiding as one
- Validation concerns noted but unresolved
- Market positioning contradicts concept
- Transformation is really just information transfer
- Cannot articulate book in one clear paragraph
During Session
**Building Book-Level Architecture:**
- Refine thesis and promise statement
- Map transformation arc (stages the reader moves through)
- Select structural framework (see references/structural-frameworks.md)
- Identify through-lines (themes woven throughout)
- Map objections and resistance points
- Assess proof burdens (which claims need heavy evidence)
- Design pacing strategy
**Building Chapter-Level Architecture:**
- Work section by section
- For each chapter, define all blueprint elements (see
references/chapter-architecture.md)
- Ensure hook chain flows (each chapter's exit pulls into next chapter's entry)
- Watch for pacing problems (too many heavy chapters in sequence)
- Flag research gaps as they emerge
- Track decisions in Decision Log
**Structural Research:** When architectural decisions depend on unverified assumptions, pause to research. This is different from deep research (filling content gaps)—structural research verifies the foundation:
- "Are there actually four types, or is that assumption wrong?"
- "Has someone else created a better framework for this?"
- "What's the strongest counterargument to this structure?"
Session End
Always conclude by:
1. Updating the Progress Tracker 2. Summarizing decisions made (add to Decision Log) 3. Listing open questions 4. Stating what to bring to next session 5. Identifying clear next steps
Inputs
**Required:**
- Book Concept Document (from book-ideation)
**Optional but valuable:**
- Validation Report (from idea-validator)
- Market Research Report (from market-research)
- Any existing outline, notes, or structural thinking
Outputs
**Master Architecture Document** — Book-level elements:
- Book Identity (title, subtitle, promise, thesis, enemy)
- Reader Profile and Transformation Arc
- Structural Framework Rationale
- Section Overview with purposes
- Through-lines
- Objection Map
- Proof Burden Map
- Pacing Strategy
- Risk Assessment
**Section Blueprint Documents** — One per section, containing detailed chapter blueprints:
- Chapter number, title, type, one-line description
- Chapter weight (Heavy/Medium/Light)
- Incoming hook, outgoing hook
- Reader emotional arc (starts/ends)
- Key insight
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 book-architect.
- Which coding agents can use book-architect?
- book-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.

