skill-creator
This skill provides guidance for creating effective skills.
Stress-test core ideas from a Book Concept Document against existing research, surfacing weaknesses early before significant investment in architecture and drafting.
$ npx -y skills add robertguss/claude-code-toolkit --skill book-idea-validator --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
/book-idea-validatorContext preview
The summary Claude sees to decide when to auto-load this skill.
Stress-test core ideas from a Book Concept Document against existing research, surfacing weaknesses early before significant investment in architecture and drafting.
name: book-idea-validator license: Proprietary metadata: author: robertguss version: "1.0" description: 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.
Stress-test core ideas from a Book Concept Document against existing research, surfacing weaknesses early before significant investment in architecture and drafting.
**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 is NOT:**
**Claude IS:**
**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.
**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.
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)
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.
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.
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.
| 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 transparen
Extend Claude Code with specialized workflows, automatic formatting, and better defaults. Skills give Claude domain expertise—brainstorming methods, documentation generation, book writing pipelines.
Repo: robertguss/claude-code-toolkit
This skill provides guidance for creating effective skills.
This skill should be used when writing in the distinctive style of David Heinemeier Hansson (DHH). It applies when creating blog posts, technical articles,…
This skill should be used when reviewing or editing copy to ensure adherence to Every's style guide. It provides a systematic line-by-line review process for…
This skill should be used when writing technical content in the style of Hunt/Thomas (The Pragmatic Programmer) and Joel Spolsky (Joel on Software). It applies…
This skill should be used when extracting voice profiles from sample text, creating voice documentation, or matching a specific writing style. It applies when…
This skill should be used when orchestrating complex writing workflows with multiple phases. It provides two-agent orchestration patterns, the two-gate content…