book-research-assistant — Claude Code skill: research for nonfiction
A skill that plans and vets research for a nonfiction book: turns fact gaps into questions, writes the prompts, and rules on each source.
npx skills add robertguss/claude-code-toolkit --skill book-research-assistant -a claude-codeWhat book-research-assistant does
The skill runs in two phases. First it takes the Research Gaps Document from book-architect and turns each gap into a self-contained deep research prompt, building a Chapter Research Tracker with gap IDs, priorities and the kind of evidence needed. Later, when you bring results back, it goes gap by gap and renders a verdict: Complete, Needs More or Problematic. Each finished chapter gets a summary, and the skill certifies whether you are ready to move on.
It does not run the research itself. You execute the deep search outside, with Claude and Gemini, while the skill handles planning, prompt writing, validation and organization. Under the hood it leans on reference files for question formulation, evidence types, source evaluation and output format.
Upstream documents are required: Research Gaps Document, Master Architecture Document and Section Blueprints from book-architect, plus the Book Concept Document from book-ideation. Without them planning will not start. The skill also treats LLM research as something that can invent sources, so checking citations and confidence flags is part of the workflow.
What it helps with
- turn fact gaps into specific research questions
- write self-contained deep research prompts
- vet each source and assign a verdict
- summarize a chapter after validation
- decide whether the book is ready for drafting
Example prompts for the agent
- Plan the research for chapter one using my Research Gaps Document
- Validate the results for chapter 3 gaps and give a verdict on each
- Produce the final research synthesis for the whole book
How to install book-research-assistant
1Skills CLI (Vercel)
npx skills add robertguss/claude-code-toolkit --skill book-research-assistant -a claude-code2Manually: put the files in place
~/.claude/skills/book-research-assistant/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/book-research-assistant/
1Skills CLI (Vercel)
npx skills add robertguss/claude-code-toolkit --skill book-research-assistant -a codex2Manually: put the files in place
.agents/skills/book-research-assistant/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add robertguss/claude-code-toolkit --skill book-research-assistant -a cursor2Manually: put the files in place
.cursor/skills/book-research-assistant/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install robertguss/claude-code-toolkit book-research-assistant2Manually: put the files in place
.github/skills/book-research-assistant/SKILL.md1Skills CLI (Vercel)
npx skills add robertguss/claude-code-toolkit --skill book-research-assistant -a gemini-cli2Platform CLI
gemini skills install https://github.com/robertguss/claude-code-toolkit --path skills/non-fiction-book-factory/book-research-assistantManually: put the files in place
.devin/skills/book-research-assistant/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add robertguss/claude-code-toolkit --skill book-research-assistant -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about book-research-assistant
How do I install book-research-assistant in Claude Code?
Run npx skills add robertguss/claude-code-toolkit --skill book-research-assistant -a claude-code. The skill then lives at ~/.claude/skills/book-research-assistant/SKILL.md.
What does book-research-assistant do?
It plans research for a nonfiction book: expands gaps from the Research Gaps Document, writes prompts, keeps trackers and validates results. The deep search itself runs outside, through Claude and Gemini.
What do I need before using the skill?
The Research Gaps Document, Master Architecture Document and Section Blueprints from book-architect, plus the Book Concept Document from book-ideation. Planning will not start without them.