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.
npx skills add robertguss/claude-code-toolkit --skill book-architect -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/book-architect/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/book-architect/
1Skills CLI (Vercel)
npx skills add robertguss/claude-code-toolkit --skill book-architect -a codex2Manually: put the files in place
.agents/skills/book-architect/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add robertguss/claude-code-toolkit --skill book-architect -a cursor2Manually: put the files in place
.cursor/skills/book-architect/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install robertguss/claude-code-toolkit book-architect2Manually: put the files in place
.github/skills/book-architect/SKILL.md1Skills CLI (Vercel)
npx skills add robertguss/claude-code-toolkit --skill book-architect -a gemini-cli2Platform CLI
gemini skills install https://github.com/robertguss/claude-code-toolkit --path skills/non-fiction-book-factory/book-architectManually: put the files in place
.devin/skills/book-architect/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add robertguss/claude-code-toolkit --skill book-architect -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.