review-doc-consistency

Validate documentation against code implementation and report inconsistencies with severity levels.

1|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/mshaheerz/hive-mind --skill review-doc-consistency-mshaheerz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-doc-consistency
Source: https://github.com/mshaheerz/hive-mind/tree/main/agent-skills/review-doc-consistency
Command: npx skills add https://github.com/mshaheerz/hive-mind --skill review-doc-consistency-mshaheerz

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) and scripts (resource) components.

What problem does it solve?

This Skill addresses the common issue of documentation becoming outdated or inconsistent with the actual code implementation, leading to confusion and errors.

Core Features & Use Cases

  • Code-Documentation Alignment: Verifies that descriptions, API specifications, and configuration details in documentation match the live code.
  • Outdated Content Detection: Identifies documentation that no longer reflects the current state of the codebase.
  • API Accuracy Verification: Ensures that API endpoints, parameters, and return values documented are precisely what the code provides.
  • Use Case: After a code refactor, use this Skill to automatically scan your README and docs/ directory to flag any sections that now contradict the updated code, ensuring users always have accurate information.

Quick Start

Use the review-doc-consistency skill to check if the project's README and documentation files are consistent with the current code implementation.

Frequently Asked Questions about review-doc-consistency

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

FAQPage Schema
How do I check if my README and API documentation match the current code implementation?

To check documentation consistency, you can validate your README and docs directory against the live codebase. This process identifies discrepancies in features, APIs, and configurations, treating the code as the source of truth to detect outdated content.

How do I verify API documentation accuracy after refactoring my codebase?

Verifying API documentation accuracy after refactoring involves scanning your docs to ensure endpoints, parameters, and return values match the updated code. This validation flags sections that contradict the implementation, ensuring users have accurate information.

What is the best way to detect outdated content in technical documentation?

Detecting outdated content in technical documentation is best done by cross-referencing docs with the live codebase. This consistency check identifies descriptions and configuration details that no longer reflect the current state of the code.

Can I validate contract files and configuration settings against my source code?

Yes, you can validate contract files and configuration settings against your source code. The validation process scans these files to identify discrepancies in security settings and configurations, prioritizing the code implementation as the source of truth.

How are documentation inconsistencies prioritized and reported?

Documentation inconsistencies are prioritized and reported using detailed reports with severity levels for each issue found. This validation process identifies discrepancies across README, docs directory, and contract files to highlight critical mismatches.

Does documentation validation work for security settings and configuration mismatches?

Documentation validation works for security settings and configuration mismatches by scanning contract files and docs. It identifies discrepancies between documented configurations and the live code, generating detailed reports with severity levels for each inconsistency.