audit-docs

Detect documentation drift between knowledge-base content and implemented code.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/dthompson-jti/safety-check-app-concept --skill audit-docs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: audit-docs
Source: https://github.com/dthompson-jti/safety-check-app-concept/tree/main/.agent/skills/audit/docs
Command: npx skills add https://github.com/dthompson-jti/safety-check-app-concept --skill audit-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Documentation drift detection and hygiene.

Core Features & Use Cases

  • Drift detection: compare knowledge-base content (SPECs, RULES, STRATEGY) against implemented code and docs to flag inconsistencies.
  • Consistency validation: ensure terminology and cross-references are aligned across docs and code.
  • Archival & hygiene: move outdated docs to archive and clean the docs root.

Quick Start

Run a documentation audit to identify drift between knowledge-base content and the codebase, then generate a report with archival recommendations.

Frequently Asked Questions about audit-docs

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

FAQPage Schema
How do I detect documentation drift between my knowledge-base and codebase?▼

Documentation drift is detected by comparing SPEC, RULES, and STRATEGY content against the implemented codebase to flag inconsistencies. This validates terminology, checks cross-references, and generates an audit report with archival recommendations for outdated docs.

What is the best way to audit knowledge-base consistency before a release?▼

Auditing knowledge-base consistency before a release involves running a periodic check that validates alignment between documentation and code. It flags contradictions and generates a report with archival recommendations to clean the docs root.

How do I archive outdated docs without losing historical reference content?▼

To archive outdated docs, run a documentation audit to identify drift and generate archival recommendations. This hygiene process moves outdated knowledge-base content to an archive, ensuring the docs root remains clean without losing historical reference material.

Does documentation drift detection work for SPEC, RULES, and STRATEGY docs?▼

Yes, documentation drift detection specifically validates SPEC-, RULES-, and STRATEGY-based docs. It compares these knowledge-base contents against the implemented codebase to ensure terminology and cross-references remain aligned across periodic audits and releases.

Why does my codebase have contradictions with my knowledge-base content?▼

Contradictions occur due to documentation drift when knowledge-base content is not updated alongside code changes. Running an audit detects these inconsistencies by comparing SPECs, RULES, and STRATEGY against the codebase and flags them in a report.