/book-ideation
Transform raw ideas into structured nonfiction book concepts through guided multi-session development.
Claude Code
$ npx -y skills add robertguss/claude-code-toolkit --skill book-ideation --agent claude-code
Codex
$ npx skills add robertguss/claude-code-toolkit --skill book-ideation -a codex -y
Cursor
$ npx skills add robertguss/claude-code-toolkit --skill book-ideation -a cursor -y
Gemini CLI
$ npx skills add robertguss/claude-code-toolkit --skill book-ideation -a gemini-cli -y
GitHub Copilot
$ npx skills add robertguss/claude-code-toolkit --skill book-ideation -a github-copilot -y
OpenCode
$ npx skills add robertguss/claude-code-toolkit --skill book-ideation -a opencode -y
Windsurf
$ npx skills add robertguss/claude-code-toolkit --skill book-ideation -a windsurf -y
SKILL.md
book-ideation.SKILL.mdname: book-ideation
license: Proprietary
metadata:
author: robertguss
version: "1.0"
description:
Develop raw book ideas into structured nonfiction book concepts. Use when the
user wants to develop a book idea, has brainstorm documents to refine into a
book concept, wants to articulate a book's
thesis/promise/reader/transformation, or needs to prepare a book concept for
validation and market research. Nonfiction only. Produces a Book Concept
Document with all elements needed for downstream skills (idea-validator,
market-research, book-architect).
Book Ideation
Transform raw ideas into structured nonfiction book concepts through guided multi-session development.
Core Philosophy
**Every decision serves the reader.** The question is never "what do I want to say?" but "what transformation does the reader need, and how can this book deliver it?"
This skill sits between generic brainstorming and book architecture. Its job is to refine raw material into a structured concept that can be validated, market-tested, and architected.
**The goal is not a book outline.** The goal is clarity on eight fundamental elements that determine whether a book should exist and what it must accomplish.
Input Types
This skill accepts:
- Raw idea (one sentence or paragraph)
- Brainstorm document from the `brainstorm` skill
- Zettelkasten notes or research collection
- Existing partial concept needing refinement
- "Shower thought" worth exploring
Session Flow
Session Start
Begin every session with:
1. **New or continuing?**
- If continuing: Request the latest Book Concept Document version
- If new: Proceed to initialization
2. **What do we have?**
- Ask user to share their raw material (brainstorm doc, notes, idea)
- Read and identify what's already clear vs. underdeveloped
3. **Session goal**
- Which elements need development today?
- Deep exploration or quick progress?
The Eight Elements
Develop these through conversation, not interrogation. Surface insights; don't extract data.
1. The Reader
_Who specifically is this for?_
Go beyond demographics. Understand:
- Their current situation (what's happening in their life/work)
- What they currently believe that isn't serving them
- What they've already tried that hasn't worked
- What's blocking them from solving this themselves
- Why they would pick up THIS book (the trigger moment)
**Probe:** "If your ideal reader walked into a bookstore, what section would they be in? What would they be feeling? What search would they have just done on Amazon?"
2. The Transformation
_Where will they be after reading?_
The reader starts at Point A and ends at Point B. Define both clearly:
- What will they believe differently?
- What will they be able to do?
- How will they feel?
- What will they stop doing?
**The gap between A and B is the book's reason for existence.**
3. The Core Thesis
_What's the one big idea?_
This is not a topic—it's a claim. A thesis takes a position. Test it:
- Can someone disagree with this? (If not, it's too obvious)
- Does it challenge conventional wisdom? (Contrarian theses are more compelling)
- Can you state it in one sentence?
**Template:** "Most people believe [conventional wisdom], but actually [your thesis], because [key insight]."
4. The Author Angle
_Why are you the one to write this?_
Credibility comes from:
- Experience (you've lived this)
- Expertise (you've studied/practiced this)
- Access (you have information others don't)
- Perspective (you see what others miss)
**You don't need all four. You need at least one that's compelling.**
5. The Stakes
_Why does this matter? Why now?_
Articulate:
- What's the cost of NOT reading this book?
- Why is this moment in time right for this message?
- What's at risk for the reader if they continue as they are?
Stakes create urgency. Without stakes, the book is a "nice to have."
6. The Key Concepts
_What are the 3-7 major ideas that support the thesis?_
These are the building blocks—the frameworks, principles, stories, or insights that make the thesis credible and actionable. They'll become chapters or sections.
Don't list 20 ideas. Force prioritization. What's essential vs. nice-to-have?
7. The Enemy
_What is this book arguing against?_
Every great nonfiction book has a villain:
- A mindset ("hustle culture")
- A practice ("inbox zero")
- Conventional wisdom ("more information = better decisions")
- A competing approach ("digital note-taking")
**The enemy clarifies the thesis by contrast.**
8. The Promise
_In one sentence, what does the reader get?_
This is the book's value proposition. It should:
- Be specific (not "improve your life")
- Be believable (not "become a millionaire in 30 days")
- Connect transformation to method
**Template:** "This book will help [reader] achieve [transformation] by [method/insight]."
During Session
**Collaboration behaviors:**
- Surface what's implicit: "It sounds like you're really saying..."
- Challenge weak elements: "I'm not convinced this thesis is contrarian enough.
Here's why..."
- Connect elements: "Your enemy suggests your reader might be someone who..."
- Push for specificity: "Can you give me an example of this reader?"
**When stuck on an element:**
- Skip it and return later (other elements may clarify it)
- Use the "Ideal Reader Interview" technique (imagine interviewing your reader)
- Try the "Anti-Book" technique (what's the opposite book? who's it for?)
Session End
Always conclude with:
1. **Element status** — Which elements are solid, developing, or still raw? 2. **Key insight** — What did we discover this session? 3. **Overnight question** — What should the user sit with? 4. **Version creation** — Generate the next version of the Book Concept Document
Quick Capture Mode
For rapid concept capture when time is short:
1. User shares raw idea 2. Extract: Reader (rough), Transformatio
Read more
name: book-ideation license: Proprietary metadata: author: robertguss version: "1.0" description: Develop raw book ideas into structured nonfiction book concepts. Use when the user wants to develop a book idea, has brainstorm documents to refine into a book concept, wants to articulate a book's thesis/promise/reader/transformation, or needs to prepare a book concept for validation and market research. Nonfiction only. Produces a Book Concept Document with all elements needed for downstream skills (idea-validator, market-research, book-architect).
Book Ideation
Transform raw ideas into structured nonfiction book concepts through guided multi-session development.
Core Philosophy
**Every decision serves the reader.** The question is never "what do I want to say?" but "what transformation does the reader need, and how can this book deliver it?"
This skill sits between generic brainstorming and book architecture. Its job is to refine raw material into a structured concept that can be validated, market-tested, and architected.
**The goal is not a book outline.** The goal is clarity on eight fundamental elements that determine whether a book should exist and what it must accomplish.
Input Types
This skill accepts:
- Raw idea (one sentence or paragraph)
- Brainstorm document from the `brainstorm` skill
- Zettelkasten notes or research collection
- Existing partial concept needing refinement
- "Shower thought" worth exploring
Session Flow
Session Start
Begin every session with:
1. **New or continuing?**
- If continuing: Request the latest Book Concept Document version
- If new: Proceed to initialization
2. **What do we have?**
- Ask user to share their raw material (brainstorm doc, notes, idea)
- Read and identify what's already clear vs. underdeveloped
3. **Session goal**
- Which elements need development today?
- Deep exploration or quick progress?
The Eight Elements
Develop these through conversation, not interrogation. Surface insights; don't extract data.
1. The Reader
_Who specifically is this for?_
Go beyond demographics. Understand:
- Their current situation (what's happening in their life/work)
- What they currently believe that isn't serving them
- What they've already tried that hasn't worked
- What's blocking them from solving this themselves
- Why they would pick up THIS book (the trigger moment)
**Probe:** "If your ideal reader walked into a bookstore, what section would they be in? What would they be feeling? What search would they have just done on Amazon?"
2. The Transformation
_Where will they be after reading?_
The reader starts at Point A and ends at Point B. Define both clearly:
- What will they believe differently?
- What will they be able to do?
- How will they feel?
- What will they stop doing?
**The gap between A and B is the book's reason for existence.**
3. The Core Thesis
_What's the one big idea?_
This is not a topic—it's a claim. A thesis takes a position. Test it:
- Can someone disagree with this? (If not, it's too obvious)
- Does it challenge conventional wisdom? (Contrarian theses are more compelling)
- Can you state it in one sentence?
**Template:** "Most people believe [conventional wisdom], but actually [your thesis], because [key insight]."
4. The Author Angle
_Why are you the one to write this?_
Credibility comes from:
- Experience (you've lived this)
- Expertise (you've studied/practiced this)
- Access (you have information others don't)
- Perspective (you see what others miss)
**You don't need all four. You need at least one that's compelling.**
5. The Stakes
_Why does this matter? Why now?_
Articulate:
- What's the cost of NOT reading this book?
- Why is this moment in time right for this message?
- What's at risk for the reader if they continue as they are?
Stakes create urgency. Without stakes, the book is a "nice to have."
6. The Key Concepts
_What are the 3-7 major ideas that support the thesis?_
These are the building blocks—the frameworks, principles, stories, or insights that make the thesis credible and actionable. They'll become chapters or sections.
Don't list 20 ideas. Force prioritization. What's essential vs. nice-to-have?
7. The Enemy
_What is this book arguing against?_
Every great nonfiction book has a villain:
- A mindset ("hustle culture")
- A practice ("inbox zero")
- Conventional wisdom ("more information = better decisions")
- A competing approach ("digital note-taking")
**The enemy clarifies the thesis by contrast.**
8. The Promise
_In one sentence, what does the reader get?_
This is the book's value proposition. It should:
- Be specific (not "improve your life")
- Be believable (not "become a millionaire in 30 days")
- Connect transformation to method
**Template:** "This book will help [reader] achieve [transformation] by [method/insight]."
During Session
**Collaboration behaviors:**
- Surface what's implicit: "It sounds like you're really saying..."
- Challenge weak elements: "I'm not convinced this thesis is contrarian enough.
Here's why..."
- Connect elements: "Your enemy suggests your reader might be someone who..."
- Push for specificity: "Can you give me an example of this reader?"
**When stuck on an element:**
- Skip it and return later (other elements may clarify it)
- Use the "Ideal Reader Interview" technique (imagine interviewing your reader)
- Try the "Anti-Book" technique (what's the opposite book? who's it for?)
Session End
Always conclude with:
1. **Element status** — Which elements are solid, developing, or still raw? 2. **Key insight** — What did we discover this session? 3. **Overnight question** — What should the user sit with? 4. **Version creation** — Generate the next version of the Book Concept Document
Quick Capture Mode
For rapid concept capture when time is short:
1. User shares raw idea 2. Extract: Reader (rough), Transformatio
Extend Claude Code with specialized workflows, automatic formatting, and better defaults. Skills give Claude domain expertise—brainstorming methods, leading a project with worker agents, project wikis, book writing pipelines.
Other skills on claude-code-toolkit.
dhh-writing
This skill should be used when writing in the distinctive style of David Heinemeier Hansson (DHH). It applies when creating blog…
every-style-editor
This skill should be used when reviewing or editing copy to ensure adherence to Every's style guide. It provides a systematic…
pragmatic-writing
This skill should be used when writing technical content in the style of Hunt/Thomas (The Pragmatic Programmer) and Joel Spolsky…
voice-capture
This skill should be used when extracting voice profiles from sample text, creating voice documentation, or matching a specific…
writing-orchestration
This skill should be used when orchestrating complex writing workflows with multiple phases. It provides two-agent orchestration…
More skills from other plugins.
prompt-lookup
Activates when the user asks about AI prompts, needs prompt templates, wants to search for prompts, or mentions prompts.chat. Use…
ppt-master
AI-driven presentation workflow for generating editable PPTX decks and slides, reconstructing page visuals, creating reusable…
morph-ppt
Use this skill when the user wants a .pptx with smooth cross-slide animation — PowerPoint Morph transitions, Keynote-style…
frontend-slides
Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to…
Questions about book-ideation.
- Which coding agents can use book-ideation?
- book-ideation installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.

