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.