Skip to main content
skill CX Codex

book-architect — Claude Code skill: what it does, how to install

Builds chapter blueprints and maps reader journeys for nonfiction books before drafting begins. Requires a validated book concept document.

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

What book-architect does

This skill structures nonfiction manuscripts around reader transformation rather than simple topical folders. It pairs structural layout with emotional pacing. Every chapter receives entry and exit states, a core insight, and hook transitions that pull into the next section.

Sessions kick off with an intake check that yields a traffic-light readiness score and flags foundational gaps. Output deliverables include a master blueprint, section-level chapter outlines, a pacing map, and a decision log. Without an upstream Book Concept Document, the process stops immediately at intake.

What it helps with

  • Design an end-to-end nonfiction book blueprint before drafting
  • Map chapter transitions and emotional pacing for the reader
  • Spot weak book concepts and logical gaps before outlining
  • Track structural decisions and open research questions

Example prompts for the agent

  • Review my book concept document and draft the overall chapter outline.
  • Build a section blueprint with reader transitions for chapter four.
  • Audit the table of contents pacing and log open research gaps.

How to install book-architect

1Skills CLI (Vercel)

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

2Manually: put the files in place

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

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

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

Questions about book-architect

How to install book-architect in Claude Code?

Run npx skills add robertguss/claude-code-toolkit --skill book-architect -a claude-code. The skill installs into ~/.claude/skills/book-architect/SKILL.md.

What does book-architect do?

It translates an approved nonfiction concept into a detailed structural blueprint, shaping the reader's journey, pacing, and chapter hooks.

What prerequisites are needed before running the skill?

A Book Concept Document is mandatory. Validation reports and market research summaries can be supplied to refine positioning and evidence requirements.

Similar skills

All skills for Writing and docs →

From the same set20

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 ebook-discovery Find ebook concepts in published work, personal expertise, audience questions, and archives. The skill assesses ideas and tracks candidates for further development. CX Codex +1 ★ 132repo stars ebook-concept-development Turns a single ebook idea into a structured concept: reader, transformation, promise, scope. Useful before you start planning the book itself. CX Codex +1 ★ 132repo stars project-wiki Builds and maintains an in-repo Karpathy-style wiki where the AI updates interconnected notes and you review decisions and concepts. CX Codex +1 ★ 132repo stars lead A skill to organize project work through a task queue. You write briefs, send each to a fresh Opus agent in Herdr, verify the outcome, and keep a record—the loop runs without stopping. 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