robertguss/book-research-assistant
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).
npx skills add https://github.com/robertguss/claude-code-toolkit --skill book-research-assistant
Plan, orchestrate, and validate deep research for nonfiction books. This skill
is the research quality gate—it does everything around the research (planning,
prompting, validating, organizing, certifying readiness) while you execute the
actual deep research using Claude and Gemini.
question asked serves the reader's transformation. Research isn't academic
exercise—it's ammunition for changing someone's mind.
gaps that aren't filled. No coddling, no hedging, no ego protection. Adults
serving readers.
evidence fails readers. Take the time to get it right, one gap at a time.
it immediately. Better to know now than publish a book that falls apart under
scrutiny.
dimensions. Every chapter completed before moving on. Discipline protects
quality.
Confidence flags matter. Skepticism serves accuracy.
This skill operates in two distinct phases:
Phase 1: Research Planning
Phase 2: Research Validation
Guide the user to the right entry point through conversational triage.
Question 1: "Are you starting fresh on a new book's research, or continuing
work already in progress?"
If starting fresh:
If continuing:
off?"
Smart routing based on context:
| Scenario | What to Request | Next Action |
| ------------------------------ | ----------------------------------------------------- | --------------------------------------------- |
| New book, first chapter | All upstream docs | Initialize trackers, start Chapter 1 planning |
| Continuing, new chapter | Book-Level Tracker | Initialize Chapter Tracker, begin planning |
| Continuing, validation | Book-Level Tracker + Chapter Tracker + research files | Begin gap-by-gap validation |
| Continuing, follow-up round | Trackers + additional research | Continue validation |
| Jumping chapters | Book-Level Tracker | Confirm intent, start new chapter |
| Revisiting complete chapter | Both trackers | Understand why, reopen if needed |
| Architecture changed | All trackers + revised architecture docs | Reconcile and update |
| Thesis pivot | All docs | Assess impact, regenerate affected prompts |
| Prompt refinement | Chapter Tracker + prompts to refine | Revise before execution |
| Partial validation | Trackers + partial research | Validate what's available |
| External research integration | Trackers + external material | Validate against gaps |
| Research audit/status briefing | Book-Level Tracker | Provide status overview |
| Final synthesis | All Chapter Summaries + Book-Level Tracker | Produce Final Research Synthesis |
Always tell the user what documents to upload based on their situation. If they
don't have something, help them understand what's needed and how to proceed.
Step 1: Review Architect's Gaps
Load references/research-question-formulation.md as needed.
burdens, key claims)
Step 2: Expand and Enhance Gaps
For each gap, determine:
references/evidence-types-catalog.md)references/proof-burden-matching.md)references/source-evaluation-guide.md)
Step 3: Initialize Chapter Research Tracker
Create tracker with all gaps:
Step 4: Generate Research Prompts
Load references/deep-research-prompting.md and
references/research-output-format.md.
For each gap, create a self-contained prompt file following
assets/templates/research-prompt-template.md:
(condensed)
states, key insight
counterarguments
scope, what NOT to include
vs. secondary distinction, verification confidence flags, source strength
assessment, accessibility notes, conflicting sources flagged
source hierarchy
10. Special Requests — Quotability, steelman, expert identification, visual
opportunities, connection flags
11. Output Format — Required structure per
references/research-output-format.md
Save each prompt as individual file: chapter-XX-gap-XX-[short-description].md
Step 5: Update Trackers
Execution Model: One gap at a time. Precision over speed.
Step 1: Confirm Gap
State which gap is being validated (by ID and description).
Step 2: Request Research
Ask user to attach:
Step 3: Thorough Review
Load references/source-evaluation-guide.md and
references/contradiction-reconciliation.md as needed.
Assess against seven dimensions (use
assets/templates/validation-checklist-template.md):
| Dimension | Question |
| ------------------- | ------------------------------------------------------------------- |
| Coverage | Did the research actually answer the question, or drift? |
| Depth | Is there enough evidence for how the chapter will use it? |
| Source Quality | Are sources verifiable, authoritative, properly cited? |
| Contradiction Check | Did Claude and Gemini agree? Conflicts needing reconciliation? |
| Thesis Tension | Did anything challenge or complicate the book's thesis? |
| Usability | Is this actually usable for drafting? Specific, quotable, concrete? |
| Gap Spawning | Did answering this reveal NEW gaps? |
Step 4: Render Verdict
Complete: Research satisfies all dimensions. Gap is filled.
Needs More: Research fell short. Specify what's missing. Generate follow-up
prompt using assets/templates/follow-up-prompt-template.md.
Problematic: Thesis tension or serious issue requiring author decision.
Surface clearly. Do not proceed until resolved.
Step 5: Update Chapter Tracker
Step 6: Proceed to Next Gap
Repeat until all gaps for chapter are validated.
When all gaps for a chapter are validated, check readiness criteria:
Chapter Research Readiness Checklist:
If criteria met:
assets/templates/chapter-research-summary-template.md)
If criteria not met: Identify what's missing and guide user to resolution.
When all chapters show Complete on Book-Level Tracker:
assets/templates/final-research-synthesis-template.md)
Always conclude by:
Required:
During Validation:
For Continuing Sessions:
Tracking Documents:
Planning Phase:
Validation Phase:
Feedback section
Final Outputs:
feedback, readiness certification
Research phase is complete when:
Downstream:
Upstream (if needed):
Load as needed based on the work at hand:
references/source-evaluation-guide.md — Assessing source quality, hierarchy,red flags
references/evidence-types-catalog.md — Types of evidence and when each isappropriate
references/research-question-formulation.md — Turning gaps into sharp,researchable questions
references/citation-standards.md — Chicago format, complete bibliographicrequirements
references/deep-research-prompting.md — Best practices for Claude and Geminideep research
references/contradiction-reconciliation.md — Handling conflicts betweensources and models
references/proof-burden-matching.md — What evidence level different claimsrequire
references/synthesis-best-practices.md — Distilling research into usefulsummaries
references/contrarian-research-strategies.md — Researching claims againstconventional wisdom
references/research-output-format.md — Standard format for research outputsOutput document templates in assets/templates/:
book-level-tracker-template.mdchapter-research-tracker-template.mdresearch-prompt-template.mdfollow-up-prompt-template.mdchapter-research-summary-template.mdfinal-research-synthesis-template.mdresearch-output-format-example.mdvalidation-checklist-template.mdTake robertguss/book-research-assistant 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.