book-ideation

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).

56 stars

Best use case

book-ideation is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

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).

Teams using book-ideation should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/book-ideation/SKILL.md --create-dirs "https://raw.githubusercontent.com/robertguss/claude-code-toolkit/main/skills/non-fiction-book-factory/book-ideation/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/book-ideation/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How book-ideation Compares

Feature / Agentbook-ideationStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

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).

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

SKILL.md Source

# 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), Transformation (rough), Thesis (rough), Promise (one
   sentence)
3. Create minimal v1 document
4. Note: "Quick capture—expand in future session"

## Readiness Criteria

A Book Concept Document is ready for validation when:

| Element        | Readiness Test                                             |
| -------------- | ---------------------------------------------------------- |
| Reader         | Can describe them as a specific person, not a category     |
| Transformation | Clear before/after with emotional and practical dimensions |
| Thesis         | One sentence, contrarian, defensible                       |
| Author Angle   | At least one compelling credibility source                 |
| Stakes         | Urgency is clear—reader feels cost of inaction             |
| Key Concepts   | 3-7 prioritized, each clearly supporting the thesis        |
| Enemy          | Named and specific                                         |
| Promise        | One sentence that a reader would find compelling           |

## Output

Use the template at `assets/templates/book-concept-template.md` for all Book
Concept Documents.

The document is versioned (v1, v2, etc.) and includes:

- All eight elements with current development status
- Session log tracking progress
- Open questions for future sessions
- Readiness assessment for downstream skills

## Structural Frameworks Reference

When discussing Key Concepts, it often helps to preview potential book
structures. See `references/nonfiction-frameworks.md` for framework options to
share with the user. This is for orientation only—structural decisions belong to
`book-architect`.

## Handoff to Downstream Skills

When the Book Concept Document is ready:

→ **idea-validator**: Will stress-test the thesis and key concepts against
existing research → **market-research**: Will assess KDP viability, competition,
and positioning → **book-architect**: Will use reader/transformation/key
concepts to design the structure

Related Skills

book-research-assistant

56
from robertguss/claude-code-toolkit

Plan, orchestrate, and validate deep research for nonfiction books. Use when an author has completed book architecture and needs to fill research gaps before outlining chapters. Triggers include requests to plan research, generate research prompts, validate research quality, or prepare for drafting. This skill does everything around deep research—planning, prompting, validating, synthesizing—but the actual research execution happens externally via Claude and Gemini deep research. Requires upstream documents from book-architect (Research Gaps Document, Master Architecture Document, Section Blueprints) and book-ideation (Book Concept Document).

book-market-research

56
from robertguss/claude-code-toolkit

Assess commercial viability of book concepts for Amazon KDP self-publishing. Use when the user has a Book Concept Document and wants to understand market demand, competition, pricing, and positioning before committing to write. Produces a Market Research Report with viability scorecard and Go/No-Go recommendation. Works standalone (commercial analysis only) or after idea-validator (integrated assessment). Nonfiction only.

book-idea-validator

56
from robertguss/claude-code-toolkit

Stress-test book concepts against existing research before committing to architecture. Use when the user has a Book Concept Document ready for validation, wants to verify their thesis is defensible, needs to understand the competitive intellectual landscape, or wants honest assessment of their idea's strengths and weaknesses. Produces a Validation Report that informs the Go/No-Go decision. Nonfiction only.

book-architect

56
from robertguss/claude-code-toolkit

Design the structural and emotional architecture for nonfiction books. Use when an author has a validated book concept and needs to create the blueprint before drafting. Triggers include requests to structure a book, create a chapter outline, design a table of contents, map the reader's journey, or plan book organization. Requires upstream documents from book-ideation (Book Concept Document) and optionally from idea-validator (Validation Report) and market-research (Market Research Report).

app-growth-playbook

56
from robertguss/claude-code-toolkit

Generate platform-specific, actionable growth playbooks for mobile apps. Use when planning a Product Hunt launch, creating TikTok/Reels content strategies, setting up Apple Search Ads campaigns, preparing App Store featuring submissions, building referral loops, designing email/push re-engagement campaigns, writing Reddit launch posts, or creating content marketing plans for app growth. Provides templates, scripts, timing guides, and step-by-step processes — not generic advice.

ebook-discovery

56
from robertguss/claude-code-toolkit

Surface ebook ideas you didn't know you had. Use when ready to discover what ebooks might be hiding in your content, expertise, or thinking. Supports both content-rich creators (blog posts, videos, newsletters) and those with unpublished expertise. Produces a curated list of ebook candidates ready for Concept Development. Handles multi-session discovery with living documents.

ebook-concept-development

56
from robertguss/claude-code-toolkit

Develop ebook ideas into structured concepts ready for architecture. Use when the user has an ebook idea (from a brainstorm document, existing content to repurpose, a book section to extract, or a fresh concept) and wants to develop it into a clear, validated concept. Produces an Ebook Concept Document with reader, transformation, promise, content source, scope/format, and key topics. Handles multi-session development with living documents.

writing-dna-discovery

56
from robertguss/claude-code-toolkit

Capture a writer's voice DNA through collaborative interview and sample analysis. Use when someone wants to document their writing voice for use with a ghost writer skill. Produces a Voice DNA Document with patterns, anti-patterns, and actionable guidance. Handles one register/mode per session, supports refinement over time.

ghost-writer

56
from robertguss/claude-code-toolkit

Produce first drafts that match a writer's authentic voice using their Voice DNA Document. Consumes DNA documents from writing-dna-discovery skill. Generates 2 meaningfully different drafts with headlines, confidence assessment, decision notes, and DNA refinement suggestions. Collaborative partner that evaluates, pushes back, and advocates for quality. Handles blog posts, essays, newsletters, and more.

chapter-architect

56
from robertguss/claude-code-toolkit

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.

paywall-pricing-optimizer

56
from robertguss/claude-code-toolkit

Design effective paywalls, structure subscription tiers, and optimize pricing for mobile apps. Covers monetization model selection, paywall screen design, pricing psychology, A/B testing strategy, and RevenueCat/StoreKit/Google Billing integration. Use when the user wants to monetize an app, design a paywall, choose between subscription vs one-time purchase, set pricing tiers, improve conversion rates, plan pricing experiments, or integrate in-app purchases. Triggers on "design my paywall", "how should I price my app", "subscription tiers", "monetization strategy", "paywall copy", "free trial length", "RevenueCat setup", "improve paywall conversion".

mobile-app-launch-checklist

56
from robertguss/claude-code-toolkit

Comprehensive step-by-step launch checklist for shipping mobile apps to the iOS App Store and Google Play Store. Covers pre-submission preparation, store asset creation, build and submission, launch day execution, and post-launch monitoring. Use when the user wants to launch a mobile app, prepare for App Store or Google Play submission, create a launch plan, review submission requirements, or ensure nothing is missed before releasing an app. Triggers on "launch checklist", "app submission", "prepare for launch", "app store submission", "google play submission", "ready to ship", "pre-launch review", "launch day plan".