Install
$ agentstack add skill-robertguss-claude-code-toolkit-chapter-architect ✓ scanned · ✓ verified, works with Claude Code, Cursor, and more.
Security review
✓ PassedNo issues found. Passed automated security review. · v0.1.0 How review works →
- ✓ Prompt-injection patterns
- ✓ Secret / credential exfiltration
- ✓ Dangerous shell & filesystem operations
- ✓ Untrusted network calls
- ✓ Known-malicious package signatures
What it can access
- ✓ Network access No
- ✓ Filesystem access No
- ✓ Shell / process execution No
- ✓ Environment & secrets No
- ✓ Dynamic code execution No
From automated source analysis of v0.1.0. “Used” means the capability is present in the source — more access means more to trust, not that it’s unsafe.
Verified badge
Passed review? Show it. Paste this badge into your README, it links to the public security report.
Reliability & compatibility
Declared compatibility
Compatibility is declared by the source manifest. End-to-end runtime verification is coming, see below.
We're building live execution health for every listing: tool-call success rate, median latency, uptime, and last-checked timestamps, measured, not self-reported. It isn't live yet, so we don't show numbers we can't stand behind.
How agent discovery & health will work →About
Chapter Architect
Transform a chapter's high-level specification (from book-architect) into a beat-level outline that guides drafting while preserving creative freedom.
Core Philosophy
- Reader-first, always. Every beat exists to move the reader toward the
chapter's destination—intellectually and emotionally.
- Compass, not GPS. The outline points direction and marks waypoints. It
does not dictate every turn. The ghostwriter has creative freedom within the structure.
- Collaborative partnership. Claude contributes ideas, challenges weak
thinking, and advocates for what serves the reader. The author has final approval on all decisions.
- Intent over prescription. Each beat captures why it exists, not just
what it contains. This enables intelligent adaptation during drafting.
- Emotional arc matters. Track not just where the reader is intellectually,
but how they feel at each stage of the journey.
Session Flow
This skill is session-flexible. Simple chapters may complete in one session. Complex chapters may need natural pause points with thinking time between.
Session Start
- Identify context:
- New chapter or continuing a previous session?
- If continuing, request the latest working draft.
- Gather inputs:
- Architecture Document (chapter specification)
- Research Dossier (chapter's section)
- Book Concept Document (reader, promise, voice)
- Any author notes on this chapter
- Confirm which chapter we're architecting and surface the key specs:
- Chapter number and working title
- Chapter's job
- Reader entry state
- Reader exit state
- Key concepts to cover
- Bridge from previous / to next chapter
Phase 1: Orient
Review inputs together. Surface any tensions, questions, or issues.
Key questions to explore:
- Is this a standard chapter or special type? (introduction, conclusion,
case-study, etc.)
- If special type, read
references/special-chapter-types.md - Is the research sufficient? Any gaps?
- Are there competing ways to approach this chapter?
- What's the emotional shape of this chapter? (tension→release,
confusion→clarity, etc.)
- Reference
references/emotional-arc-patterns.mdas needed
Claude's role: Surface concerns, ask probing questions, identify what's unclear or underdeveloped.
Pause point: If significant unresolved questions emerge, pause here to resolve them before proceeding.
Phase 2: Brainstorm Beats
Generate candidate beats without worrying about sequence yet.
Process:
- Review the beat vocabulary together
- Read
references/beat-vocabulary.md
- Generate possible beats—both author and Claude contribute
- Consider opening options
- Reference
references/opening-strategies.md
- Consider closing options
- Reference
references/closing-strategies.md
- Capture all candidates without judging yet
Claude's role: Actively contribute beat ideas, not just record. Suggest moves the author might not have considered. Ask "what about a beat that does X?"
Phase 3: Sequence and Debate
Put the beats in order. This is where real collaboration happens.
Process:
- Propose an initial sequence
- Walk through the reader's experience: "They arrive here, then this happens,
now they feel..."
- Debate ordering decisions:
- Does the counterargument come before or after the main case?
- Where does the reader need relief or breathing room?
- What must be established before something else can land?
- Identify which beats are load-bearing (structural, can't move) vs. flexible
- Cut beats that aren't earning their place
- Add beats if gaps emerge
Claude's role: Advocate for what serves the reader. Push back when a sequence feels off. Offer alternatives with reasoning.
Pause point: If the sequence isn't clicking, pause here. Complex chapters may need marinating time.
Phase 4: Flesh Out Beats
For each beat in the final sequence, define:
- Beat name and type (from vocabulary)
- What happens (loosely described—compass, not GPS)
- Reader destination (intellectual and emotional—this is non-negotiable)
- Key material (specific pointers to research, quotes, examples)
- Load-bearing flag (yes/no—can this beat be moved or cut?)
- Notes (anything the ghostwriter should know)
Special attention: Opening and closing beats get deeper treatment.
- _Reference
references/opening-strategies.mdand
references/closing-strategies.md_
- Articulate why this opening/closing works
- Note what to avoid
- Identify specific hooks, callbacks, or images to consider
Phase 5: Review and Finalize
Stress-test the complete arc before producing the document.
Process:
- Claude walks through the reader's experience aloud—beat by beat, tracking
intellectual and emotional state
- Check against common problems
- Read
references/common-chapter-problems.md
- Verify the chapter delivers on its job and reaches the exit state
- Confirm the bridge to the next chapter works
- Final author approval
Only after approval: Produce the Chapter Outline Document using the template.
- Use
assets/templates/chapter-outline-template.md
Session End
- Produce the versioned Chapter Outline Document (v1, v2, etc.)
- Summarize any open questions or flags for the ghostwriter
- Confirm next steps:
- Ready for drafting? → Handoff to draft-coach or ghostwriter
- Need another session? → Note where to resume
Inputs
| Document | Source | Purpose | | --------------------- | -------------------- | ------------------------------------------------------- | | Architecture Document | book-architect | Chapter's job, entry/exit states, key concepts, bridges | | Research Dossier | research-assistant | Evidence, examples, quotes organized by chapter | | Book Concept Document | book-ideation | Reader, promise, thesis, voice, author angle | | Author notes | Author | Any existing thoughts, fragments, or constraints |
Outputs
Chapter Outline Document containing:
- Chapter Context (job, entry/exit states, connections, emotional arc, tone
notes)
- Reader Journey Walkthrough (prose narrative of the experience)
- Beat Sequence (detailed breakdown of each beat)
- Opening and Closing Deep Dives (expanded treatment)
See assets/templates/chapter-outline-template.md for exact format.
Readiness Criteria
Before handoff, confirm:
- [ ] All beats have clear reader destinations (intellectual and emotional)
- [ ] Load-bearing beats are flagged
- [ ] Key material is curated and pointed to for each beat
- [ ] Opening and closing have deep-dive treatment
- [ ] Reader journey walkthrough captures the chapter's feel
- [ ] The chapter delivers on its job and exit state
- [ ] Bridge to next chapter is clear
- [ ] Author has approved the outline
Handoff
The Chapter Outline Document feeds into:
draft-coach— if author is writing and wants feedbackghostwriter(modal) — if Claude is drafting and author approves
The ghostwriter also receives the full Research Dossier for the chapter, with the outline's key material pointers as primary guidance.
Source & license
This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.
- Author: robertguss
- Source: robertguss/claude-code-toolkit
- License: MIT
- Homepage: https://robertguss.github.io/claude-skills/
Install and usage instructions live in the source repository linked above.
Reviews
No reviews yet, be the first.
Write a review
Versions
- v0.1.0 Imported from the upstream source.