skills/non-fiction-book-factory/book-architect/SKILL.md
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).
npx skillsauth add robertguss/claude-skills book-architectInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
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?"
Reader-first architecture. Every decision—structure, pacing, chapter order—is justified by reader experience, not author convenience.
Dual architecture. Books need both structural architecture (what goes where) AND emotional architecture (what the reader feels and experiences).
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.
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.
Diagnose before prescribing. Every book is different. Assess what THIS book needs rather than applying a formula.
If continuing previous work:
If starting new:
Read all provided documents and produce:
Synthesis Statement — "Here's what I understand this book to be..." (2-3 paragraphs capturing thesis, reader, transformation, key concepts)
Readiness Verdict — Green / Yellow / Red
Structural Intuitions — Initial hunches about framework, shape, challenges. Not decisions—starting points for exploration.
Concerns & Questions — Specific issues to address. Tensions, ambiguities, potential problems.
The Burning Question — The single most important thing to resolve.
Proposed Work Plan — Based on book complexity:
Readiness Signals (Green):
Red Flags (needs upstream work):
Building Book-Level Architecture:
Building Chapter-Level Architecture:
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:
Always conclude by:
Required:
Optional but valuable:
Master Architecture Document — Book-level elements:
Section Blueprint Documents — One per section, containing detailed chapter blueprints:
Research Gaps Document — Consolidated gaps with:
Progress Tracker — Session continuity:
Decision Log — Architectural choices:
Architecture is complete when:
Completed architecture feeds:
Load as needed based on the work at hand:
references/structural-frameworks.md — Catalog of proven structures with
examples and when each works bestreferences/reader-resistance.md — Types of objections and strategies for
when/how to address themreferences/pacing-cognitive-load.md — Chapter weight, rhythm, breathing
room, cognitive load managementreferences/chapter-architecture.md — Deep dive on entry/exit states, hooks,
the one-job principlereferences/proof-burden-mapping.md — Which claims need what level of
evidencereferences/question-chain.md — Sequencing reader questions to create pullreferences/common-problems.md — Architectural antipatterns and how to fix
themOutput document templates in assets/templates/:
master-architecture-template.mdsection-blueprint-template.mdresearch-gaps-template.mdprogress-tracker-template.mddecision-log-template.mddocumentation
Capture a writer's voice DNA through collaborative interview and sample analysis. Use when someone wants to document their writing voice for use with a ghost writer skill. Produces a Voice DNA Document with patterns, anti-patterns, and actionable guidance. Handles one register/mode per session, supports refinement over time.
testing
Produce first drafts that match a writer's authentic voice using their Voice DNA Document. Consumes DNA documents from writing-dna-discovery skill. Generates 2 meaningfully different drafts with headlines, confidence assessment, decision notes, and DNA refinement suggestions. Collaborative partner that evaluates, pushes back, and advocates for quality. Handles blog posts, essays, newsletters, and more.
documentation
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.
testing
Plan, orchestrate, and validate deep research for nonfiction books. Use when an author has completed book architecture and needs to fill research gaps before outlining chapters. Triggers include requests to plan research, generate research prompts, validate research quality, or prepare for drafting. This skill does everything around deep research—planning, prompting, validating, synthesizing—but the actual research execution happens externally via Claude and Gemini deep research. Requires upstream documents from book-architect (Research Gaps Document, Master Architecture Document, Section Blueprints) and book-ideation (Book Concept Document).