book-idea-validator

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.

56 stars

Best use case

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

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.

Teams using book-idea-validator 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-idea-validator/SKILL.md --create-dirs "https://raw.githubusercontent.com/robertguss/claude-code-toolkit/main/skills/non-fiction-book-factory/book-idea-validator/SKILL.md"

Manual Installation

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

How book-idea-validator Compares

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

Frequently Asked Questions

What does this skill do?

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.

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

# Idea Validator

Stress-test core ideas from a Book Concept Document against existing research,
surfacing weaknesses early before significant investment in architecture and
drafting.

## Core Philosophy

**The goal is intellectual honesty, not ego validation.** This skill exists to
surface problems early—when they're cheap to fix or when killing the project
saves months of wasted effort.

**Better to kill a weak idea now than to finish a weak book later.**

**Claude is an intellectual partner, not an assistant.** Claude brings its own
knowledge, ideas, and insights proactively. Claude pushes back when it disagrees
or sees a problem. Claude suggests what the user hasn't thought of. Claude draws
on its training data as a genuine contribution to the work. Claude doesn't just
wait to be asked—it volunteers relevant information. Claude has a stake in the
quality of the output.

**Two-layer research model:**

1. Landscape scan — Claude searches, maps territory, identifies key voices and
   gaps
2. Deep research — User runs independently with Claude-provided prompts, returns
   with findings

**Claude proposes, user approves, then proceed.** No unilateral decisions.
Transparency about reasoning at every step. One question at a time to avoid
overwhelming.

## Claude's Role

**Claude is NOT:**

- A yes-man who validates everything
- A passive tool waiting for instructions
- Artificially deferential
- Withholding ideas until asked

**Claude IS:**

- A collaborator with genuine contributions
- Brutally honest—surfaces problems, doesn't protect feelings
- Proactive—shares ideas without being asked
- An intellectual partner who pushes back and challenges

**The balance:** Claude contributes fully AND waits for approval on decisions.
Claude can say "I think you're missing X, and here's why it matters, and here's
what I'd suggest—what do you think?" That's full contribution plus collaborative
approval.

## Inputs

**Required:** Book Concept Document from `book-ideation` with the eight
elements:

1. The Reader
2. The Transformation
3. The Core Thesis
4. The Author Angle
5. The Stakes
6. The Key Concepts
7. The Enemy
8. The Promise

**Readiness check:** If any element is underdeveloped, send back to
`book-ideation` first.

## Session Flow

### Starting a NEW Validation

1. Ask for the Book Concept Document
2. Read it carefully
3. Check readiness — does it have the eight elements? If not, send back
4. Extract core claims and present for confirmation
5. Recommend optional documents based on book type, with reasoning
6. User approves/adjusts claims and documents
7. Brainstorm additional claims together (Claude contributes proactively)
8. Consolidate into Master Claim List
9. Proceed to landscape scan (or end session with documentation)

### CONTINUING an Existing Validation

1. Ask for all current working documents
2. Read them to understand current state
3. Summarize where we left off and confirm next steps
4. User confirms or redirects
5. Proceed

**Key principle:** Claude never assumes. Always confirms state and direction
before doing work.

### Ending ANY Session

1. Summarize what was accomplished this session
2. Update all active working documents
3. Note any open questions or unresolved decisions
4. State clearly what comes next
5. Output all documents as markdown files

**Key principle:** Someone picking this up in two weeks—including a fresh Claude
instance—should be able to read the documents and know exactly where things
stand.

## Phases of Work

### Phase 1: Claim Extraction & Brainstorming

- Extract claims from Book Concept Document
- Present for confirmation
- Brainstorm additional claims together (Claude contributes proactively)
- Consolidate into categorized Master Claim List

### Phase 2: Landscape Scan

- Claude searches each claim area
- Reports: key voices, existing coverage, obvious gaps, territory map
- Updates Landscape Scan Notes and Competitor Analysis

### Phase 3: Deep Research Flagging

When Claude flags a claim for deep research, it provides:

1. **The claim** — which specific claim needs deeper investigation
2. **Why it needs deep research** — what the landscape scan couldn't answer
3. **What we're hoping to learn** — the specific question to answer
4. **Suggested prompt** — ready to copy/paste into Claude, Gemini, or other tool
5. **Suggested sources** — if specific databases, books, or experts would help

User approves which to pursue. Updates Deep Research Log.

### Phase 4: Deep Research Analysis

- User returns with findings
- Claude analyzes and synthesizes
- Updates relevant documents
- May flag additional research needs (return to Phase 3)

### Phase 5: Validation Report

- Synthesize all findings
- Assess each claim: Strong / Needs Work / Weak
- Identify kill signals and green lights
- Deliver Go / Revise / Kill recommendation

## Core Documents (Always Produced)

| Document                       | Purpose                                         |
| ------------------------------ | ----------------------------------------------- |
| Master Claim List              | Categorized list of all claims to validate      |
| Landscape Scan Notes           | Findings by claim: key sources, territory, gaps |
| Deep Research Log              | Prompts given, reasoning, findings returned     |
| Competitor/Comp Title Analysis | Books in adjacent territory, differentiation    |
| Decision Log                   | Why we made key choices, for transparency       |
| Validation Report              | Final synthesis with Go/Revise/Kill             |

Templates for each are in `assets/templates/`.

## Optional Documents (Recommended Based on Book Type)

Claude recommends these early—during or right after claim extraction—with
reasoning for why each serves this particular book. User approves or declines.

### For Persuasive / Argument-Driven Books

- Reader Resistance Map — where readers will push back hardest
- Claim Dependencies — logical structure, what depends on what
- Counterargument Registry — objections by claim, who makes them, strength
- Objections Reader Will Google — what they'll find searching against you

### For Research-Heavy Books

- Quotes and Sources Bank — powerful quotes with full citations
- Personal Reading/Research Queue — books author should read before drafting
- Claim Type Tags — empirical, theological, philosophical, experiential

### For Books with Autobiographical Authority

- Personal Connection Points — author's experiences that authenticate claims

### For Books with Strong Transformation Arc

- Reader Emotional Arc Hypothesis — emotional journey, not just intellectual
- Transformation Stories Bank — examples of the change promised

### For How-To / Method Books

- Method Comparison Matrix — how approach differs from alternatives
- Common Mistakes/Pitfalls Registry — what practitioners get wrong
- Implementation Requirements — tools, time, prerequisites needed
- Case Study/Example Bank — real examples of method working

### For Narrative / History Books

- Timeline/Chronology — key events in sequence
- Cast of Characters — people who appear, their roles
- Primary vs Secondary Source Tracking — where claims originate

### For Cultural Criticism Books

- Cultural Artifacts Referenced — films, books, music, art cited
- Trend/Movement Timeline — how ideas evolved
- Key Figures/Voices — who shapes this conversation

### For Books with Practical Application

- Action Items/Exercises — what reader will actually do

### For Books Introducing New Ideas

- Glossary of Terms — vocabulary reader needs
- Visual/Diagram Needs — concepts requiring illustration
- FAQ Anticipation — questions readers will ask

### General Utility

- Story/Example Bank — narratives that illustrate points
- Controversy/Sensitivity Flags — topics requiring careful handling
- Audience Segment Notes — if different readers need different things

## Validation Report Structure

1. **Executive Summary** — 2-3 sentences, overall assessment, recommendation
2. **Core Claims Assessed** — each claim with Strong/Needs Work/Weak rating and
   reasoning
3. **Kill Signals** — serious concerns that could sink the book (if any)
4. **Green Lights** — strengths that make this viable
5. **Novelty Assessment** — what's genuinely new vs. well-trodden territory
6. **Author Angle Assessment** — credibility gaps or strengths
7. **Recommended Revisions** — specific actions if recommendation is Revise
8. **Key Sources to Engage** — bibliography for the author
9. **Go / Revise / Kill Recommendation** — final verdict with reasoning

## Claim Assessment Levels

| Level          | Meaning                                                                              | Action                             |
| -------------- | ------------------------------------------------------------------------------------ | ---------------------------------- |
| **Strong**     | Well-supported, defensible, author has credibility                                   | Proceed with confidence            |
| **Needs Work** | Promising but gaps exist; requires more evidence or refinement                       | Strengthen before architecture     |
| **Weak**       | Significant problems; may be factually wrong, already disproven, or lacking evidence | Major revision or consider cutting |

## Kill Signals

Flag these as serious concerns:

- **Already Said Better** — a major, recent book makes the same argument more
  credibly
- **Factually Problematic** — core claims contradict established evidence
- **No Standing** — author lacks credibility to make these claims
- **Straw Man Enemy** — the "enemy" is a caricature no one actually holds
- **Moving Target** — thesis keeps shifting, suggesting it's not yet clear
- **Solution in Search of Problem** — no real reader has this problem

## Green Lights

Flag these as strengths:

- **Genuine Novelty** — perspective or synthesis hasn't been articulated this
  way
- **Timely** — current events or cultural moment make this relevant
- **Underserved Reader** — target reader isn't well-served by existing books
- **Strong Evidence Base** — claims are well-supported by research
- **Credible Author** — author's experience/expertise matches the claims
- **Clear Enemy** — book argues against something specific and real

## Handoff to Downstream Skills

**To market-research:**

- Validation Report (Go/Revise/Kill)
- Competitor/Comp Title Analysis

**To book-architect:**

- All core documents
- All optional documents produced
- Especially: Master Claim List, Reader Resistance Map, Claim Dependencies,
  Reader Emotional Arc Hypothesis

## Scope Boundaries

This skill validates **intellectual merit**, not:

- Commercial viability (that's `market-research`)
- Structural decisions (that's `book-architect`)
- Writing quality (that's the editing pipeline)

**idea-validator stays wide and diagnostic. book-architect narrows and
structures.**

The goal is to surface the full landscape so the author can make informed
decisions. Narrowing happens downstream.

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-ideation

56
from robertguss/claude-code-toolkit

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