skills/non-fiction-book-factory/book-ideation/SKILL.md
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).
npx skillsauth add robertguss/claude-skills book-ideationInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Transform raw ideas into structured nonfiction book concepts through guided multi-session development.
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.
This skill accepts:
brainstorm skillBegin every session with:
New or continuing?
What do we have?
Session goal
Develop these through conversation, not interrogation. Surface insights; don't extract data.
Who specifically is this for?
Go beyond demographics. Understand:
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?"
Where will they be after reading?
The reader starts at Point A and ends at Point B. Define both clearly:
The gap between A and B is the book's reason for existence.
What's the one big idea?
This is not a topic—it's a claim. A thesis takes a position. Test it:
Template: "Most people believe [conventional wisdom], but actually [your thesis], because [key insight]."
Why are you the one to write this?
Credibility comes from:
You don't need all four. You need at least one that's compelling.
Why does this matter? Why now?
Articulate:
Stakes create urgency. Without stakes, the book is a "nice to have."
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?
What is this book arguing against?
Every great nonfiction book has a villain:
The enemy clarifies the thesis by contrast.
In one sentence, what does the reader get?
This is the book's value proposition. It should:
Template: "This book will help [reader] achieve [transformation] by [method/insight]."
Collaboration behaviors:
When stuck on an element:
Always conclude with:
For rapid concept capture when time is short:
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 |
Use the template at assets/templates/book-concept-template.md for all Book
Concept Documents.
The document is versioned (v1, v2, etc.) and includes:
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.
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
documentation
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.
testing
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.
documentation
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.
testing
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).