Interview Docs — Documentation skill for Claude Code
Walk every markdown doc, triage each for real questions (scenario gaps, contradictions, vague claims), interview the user in batches of three, and apply the answers back into the doc.
How to install Interview Docs
Installs to ~/.claude/skills/robertsolves-agent-commands-interview-docs/SKILL.md
mkdir -p ~/.claude/skills/robertsolves-agent-commands-interview-docs && curl -fsSL https://raw.githubusercontent.com/robertsolves/agent-commands/HEAD/commands/interview-docs.md -o ~/.claude/skills/robertsolves-agent-commands-interview-docs/SKILL.md Restart Claude Code, or start a new session, for it to be picked up.
What Interview Docs does
description: Walk every markdown doc, triage each for real questions (scenario gaps, contradictions, vague claims), interview the user in batches of three, and apply the answers back into the doc. Run when asked to interview the user about the docs, or to settle product intent that the docs leave open. Not for questions about source code — use /interview-code; not for one risky code spot — use /interview-risky-spot; not for syncing docs with the code without asking — use /update-docs; not fo
Alternatives in Documentation
- Question — Answer the user's question by analyzing the project structure and documentation 3.4k ★
- Wiki Candidates — Review and triage candidate wiki pages — promote, merge, or discard 375 ★
- Apply Self Review — Apply the approved improvements from the latest memory-self-review PROPOSAL 297 ★
Full documentation available on GitHub
View Source RepositoryRelated Skills
Docs Why
Interactive documentation improvement - ask the domain expert "why" questions, then write prose from their ans
Draft Readable Rfd
When writing or editing an RFD README, apply three read-cold rules so a fresh reader can understand the docume
Supergrill
Evidence-first interrogation protocol for Claude: recon, three depth levels, fact triage, resumable briefs. A
Gaia Cleanse
Cleanses memory and auto-loaded files (CLAUDE.md, rules) of duplication with the wiki, contradictions with the
Doc Review Team
Запускает параллельное ревью документации через Agent Team из 4 субагентов (gaps, completeness, contradictions
Vulyk Bootstrap
Adapt VULYK to this project - interview, tailor constitution, build initial map, seed wiki
Related Agents
Memory Reviewer
Reviews a draft memory note against the most similar existing notes and answers PASS or FAIL - catches duplica
Fact Finder
Answers one factual question from the code, the docs, memory, or the web, with file and line evidence, so an i
Interview Panel
Generates and stress-tests interview answers from three independent perspectives (hiring manager, peer enginee