robertsolves

Interview Docs — Documentation skill for Claude Code

Documentation community

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

Terminal
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 Repository