docs-guard

Verify documentation claims against codebase evidence for accuracy.

Updated Dec 5, 2025
One-click install
npx skills add https://github.com/ApothecaryMan/pharmaflow-ai --skill docs-guard-apothecaryman
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docs-guard
Source: https://github.com/ApothecaryMan/pharmaflow-ai/tree/main/.agents/skills/docs-guard
Command: npx skills add https://github.com/ApothecaryMan/pharmaflow-ai --skill docs-guard-apothecaryman

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill addresses the challenge of maintaining accurate and up-to-date documentation across various codebases, ensuring that documentation aligns with the actual code and behavior.

Core Features & Use Cases

  • Documentation Review: Checks for inconsistencies and inaccuracies in documentation against the codebase.
  • Code-Documentation Alignment: Ensures that documentation reflects the actual code and behavior.
  • Use Case: Before publishing documentation, use this Skill to verify that every claim in the documentation matches the codebase, preventing "docs vs. code" drift.

Quick Start

Review the documentation for accuracy by running the 'docs-guard' skill on your codebase.

Frequently Asked Questions about docs-guard

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

FAQPage Schema
How do I check documentation accuracy against my codebase?

To check documentation accuracy, verify every claim against the actual codebase to identify false statements and inconsistencies. This process ensures your technical documentation reflects the real code behavior and prevents drift.

What is documentation drift and how do I prevent it?

Documentation drift occurs when technical docs become outdated relative to code changes. You prevent drift by verifying that every documentation claim is backed by concrete code evidence before publishing or updating your project.

How do I verify that technical documentation matches the actual code behavior?

You verify documentation matches code by scanning the codebase to find evidence backing each documented claim. This alignment check detects inconsistencies and ensures technical docs accurately describe the current implementation.

Does docs-guard work for maintaining high-quality technical documentation in large software projects?

Yes, this verification approach is suitable for maintaining high-quality technical documentation in software projects. It systematically checks for false claims and inconsistencies across the codebase to ensure documentation accuracy.

What is the best way to review documentation for inconsistencies before publishing?

The best way to review documentation for inconsistencies is to run an automated verification process against your codebase before publishing. This ensures every documentation claim is supported by actual code evidence, preventing false claims.

When should I not use automated documentation verification?

Automated documentation verification is not ideal for subjective content like tutorials or conceptual overviews lacking direct code references. It works best for verifying specific technical claims, behavior, and implementation details against codebase evidence.