doc-review

The doc-review skill is designed to systematically review documentation to ensure factual accuracy and internal consistency, with a specific focus on claims about how toolhive works. It addresses a common problem in technical documentation: outdated, incorrect, or misleading statements that can confuse users or misrepresent system behavior. By carefully reading the provided documentation and validating its assertions, this skill helps maintain trust and reliability in written materials without altering the original content directly.

At its core, the skill reads documentation and evaluates several key aspects. It verifies that all claims about toolhive are accurate, checks that examples reflect real behavior, and reviews formatting and typographical correctness. It also validates that links point to existing files and that the linked content matches expectations. For fact-checking, the skill follows established guidance referenced in CHECKING.md and uses examples from EXAMPLES.md as a basis for how verification should be performed. Rather than editing text inline, it compiles findings into a structured report, presenting each issue as an item in a todo list for manual review.

This skill is well suited for teams and individuals responsible for maintaining technical documentation, including technical writers, developers, and maintainers of toolhive-related docs. It can be used during documentation reviews before releases, as part of quality assurance workflows, or when auditing existing documentation for accuracy. By separating review feedback from direct edits, it supports collaborative review processes where changes are discussed and applied deliberately. The target users are those who need a reliable, process-driven way to assess documentation quality without introducing unverified assumptions or automated rewrites.