skill-creator
This skill provides guidance for creating effective skills.
Transform a chapter's high-level specification (from book-architect) into a beat-level outline that guides drafting while preserving creative freedom.
$ npx -y skills add robertguss/claude-code-toolkit --skill chapter-architect --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
/chapter-architectContext preview
The summary Claude sees to decide when to auto-load this skill.
Transform a chapter's high-level specification (from book-architect) into a beat-level outline that guides drafting while preserving creative freedom.
name: chapter-architect license: Proprietary metadata: author: robertguss version: "1.0" description: 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.
Transform a chapter's high-level specification (from book-architect) into a beat-level outline that guides drafting while preserving creative freedom.
1. **Reader-first, always.** Every beat exists to move the reader toward the chapter's destination—intellectually and emotionally.
2. **Compass, not GPS.** The outline points direction and marks waypoints. It does not dictate every turn. The ghostwriter has creative freedom within the structure.
3. **Collaborative partnership.** Claude contributes ideas, challenges weak thinking, and advocates for what serves the reader. The author has final approval on all decisions.
4. **Intent over prescription.** Each beat captures _why_ it exists, not just _what_ it contains. This enables intelligent adaptation during drafting.
5. **Emotional arc matters.** Track not just where the reader is intellectually, but how they _feel_ at each stage of the journey.
This skill is session-flexible. Simple chapters may complete in one session. Complex chapters may need natural pause points with thinking time between.
1. **Identify context:**
2. **Gather inputs:**
3. **Confirm which chapter** we're architecting and surface the key specs:
Review inputs together. Surface any tensions, questions, or issues.
**Key questions to explore:**
case-study, etc.)
confusion→clarity, etc.)
**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.
Generate candidate beats without worrying about sequence yet.
**Process:**
1. Review the beat vocabulary together
2. Generate possible beats—both author and Claude contribute 3. Consider opening options
4. Consider closing options
5. 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?"
Put the beats in order. This is where real collaboration happens.
**Process:**
1. Propose an initial sequence 2. Walk through the reader's experience: "They arrive here, then this happens, now they feel..." 3. Debate ordering decisions:
4. Identify which beats are load-bearing (structural, can't move) vs. flexible 5. Cut beats that aren't earning their place 6. 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.
For each beat in the final sequence, define:
**Special attention:** Opening and closing beats get deeper treatment.
`references/closing-strategies.md`_
Stress-test the complete arc before producing the document.
**Process:**
1. Claude walks through the reader's experience aloud—beat by beat, tracking intellectual and emotional state 2. Check against common problems
3. Verify the chapter delivers on its job and reaches the exit state 4. Confirm the bridge to the next chapter works 5. Final author approval
**Only after approval:** Produce the Chapter Outline Document using the template.
1. Produce the versioned Chapter Outline Document (v1, v2, etc.) 2. Summarize any open questions or flags for the ghostwriter 3. Confirm next steps:
| Document | Source | Purpose
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…