skill-creator
This skill provides guidance for creating effective skills.
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?"
$ npx -y skills add robertguss/claude-code-toolkit --skill book-architect --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
/book-architectContext preview
The summary Claude sees to decide when to auto-load this skill.
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?"
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).
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?"
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.
**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:
2. Conduct intake assessment (see Intake Process below)
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
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:
**Readiness Signals (Green):**
**Red Flags (needs upstream work):**
**Building Book-Level Architecture:**
**Building Chapter-Level Architecture:**
references/chapter-architecture.md)
**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:
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
**Required:**
**Optional but valuable:**
**Master Architecture Document** — Book-level elements:
**Section Blueprint Documents** — One per section, containing detailed chapter blueprints:
Extend Claude Code with specialized workflows, automatic formatting, and better defaults. Skills give Claude domain expertise—brainstorming methods, documentation generation, book writing pipelines.
Repo: robertguss/claude-code-toolkit
This skill provides guidance for creating effective skills.
This skill should be used when writing in the distinctive style of David Heinemeier Hansson (DHH). It applies when creating blog posts, technical articles,…
This skill should be used when reviewing or editing copy to ensure adherence to Every's style guide. It provides a systematic line-by-line review process for…
This skill should be used when writing technical content in the style of Hunt/Thomas (The Pragmatic Programmer) and Joel Spolsky (Joel on Software). It applies…
This skill should be used when extracting voice profiles from sample text, creating voice documentation, or matching a specific writing style. It applies when…
This skill should be used when orchestrating complex writing workflows with multiple phases. It provides two-agent orchestration patterns, the two-gate content…