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 skills add https://github.com/robertguss/claude-code-toolkit --skill book-ideation
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:
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:
Here's why..."
When stuck on an element:
Always conclude with:
For rapid concept capture when time is short:
sentence)
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
Create time-boxed technical spike documents for researching and resolving critical development decisions before implementation.
Automatically convert Confluence specification documents into structured Jira backlogs with Epics and implementation tickets. When an agent needs to: (1) Create Jira tickets from a Confluence page, (2) Generate a backlog from a specification, (3) Break down a spec into implementation tasks, or (4) Convert requirements into Jira issues. Handles reading Confluence pages, analyzing specifications, creating Epics with proper structure, and generating detailed implementation tickets linked to the Epic.
Grilling session that challenges your plan against the existing domain model, sharpens terminology, and updates documentation (CONTEXT.md, ADRs) inline as decisions crystallise. Use when user wants to stress-test a plan against their project's language and documented decisions.
Guidelines for clinical decision support (CDS) documents: biomarker-stratified cohort analyses and GRADE-graded treatment reports. Covers structure, executive summaries, evidence grading (1A–2C), stats (HR, CI, survival), and biomarker integration. Use for pharma research docs, clinical guidelines, regulatory submissions.
Generate professional clinical decision support (CDS) documents for pharmaceutical and clinical research settings, including patient cohort analyses (biomarker-stratified with outcomes) and treatment recommendation reports (evidence-based guidelines with decision algorithms). Supports GRADE evidence grading, statistical analysis (hazard ratios, survival curves, waterfall plots), biomarker integration, and regulatory compliance. Outputs publication-ready LaTeX/PDF format optimized for drug development, clinical research, and evidence synthesis.
Guides through Trail of Bits' 5-step secure development workflow. Runs Slither scans, checks special features (upgradeability/ERC conformance/token integration), generates visual security diagrams, helps document security properties for fuzzing/verification, and reviews manual security areas.
Document architecture decisions with ADR (Architecture Decision Records). Use when making significant technical decisions, choosing between alternatives, or when onboarding needs context on past decisions.
Plan-approval workflow patterns for user control over AI actions in Claude Code Waypoint Plugin. Use when planning complex changes, need user approval before execution, want to prevent mistakes, or need to document proposed changes. Covers plan creation, approval checkpoints, plan deviation tracking, revision management, and learning from approved/rejected plans.
Take robertguss/book-ideation from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.