doc-review

Identify factual claims in documentation and assess their accuracy against ToolHive's real-world behavior.

2.0k|272|Updated Mar 12, 2025
One-click install
npx skills add https://github.com/stacklok/toolhive --skill doc-review-stacklok
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-review
Source: https://github.com/stacklok/toolhive/tree/main/.claude/skills/doc-review
Command: npx skills add https://github.com/stacklok/toolhive --skill doc-review-stacklok

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reviews documentation for factual accuracy and consistency, reducing the risk of spreading incorrect claims.

Core Features & Use Cases

  • Verify that all documented claims about ToolHive's behavior align with real capabilities.
  • Validate diagrams, examples, and links for accuracy and relevance.
  • Produce a structured, todo-based report highlighting issues without suggesting inline code changes.

Quick Start

Review the target documentation with this skill to generate a prioritized todo list of factual discrepancies and improvement opportunities.

Frequently Asked Questions about doc-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fact-check documentation for accuracy against real behavior?

To fact-check documentation, identify factual claims and assess them against real-world behavior to ensure accuracy. This process validates examples, diagrams, and links, generating a structured, audit-ready report with prioritized todos for improvement.

What is documentation verification and when do I need an audit report?

Documentation verification is the process of confirming that documented claims align with actual capabilities. You need an audit report when validating READMEs, API docs, or tutorials to reduce the risk of spreading incorrect claims and ensure factual consistency.

Can I verify links and examples in API docs and tutorials?

Yes, you can verify links and examples in API docs and tutorials by assessing their accuracy and relevance against real-world behavior. This validation ensures that documented instructions and visual aids remain factually correct and consistent.

How do I generate a todo-based report for documentation discrepancies?

Generate a todo-based report by reviewing target documentation to identify factual discrepancies and improvement opportunities. The resulting structured report highlights issues with prioritized todos, providing an audit-ready output without suggesting inline code changes.

What is the best way to audit README files for factual consistency?

The best way to audit README files for factual consistency is to review them systematically, checking claims against real capabilities. This approach produces a prioritized todo list of factual discrepancies, ensuring documentation remains accurate and reliable without inline code changes.

Does documentation fact-checking provide inline code changes?

Documentation fact-checking does not provide inline code changes. Instead, it produces a structured, todo-based report that highlights factual discrepancies and improvement opportunities, maintaining an audit-ready format for resolving issues.