docs-audit

Audit documentation completeness and freshness using the Diataxis framework.

489|254|Updated Apr 5, 2026
One-click install
npx skills add https://github.com/me2resh/apexyard --skill docs-audit-me2resh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docs-audit
Source: https://github.com/me2resh/apexyard/tree/main/marketplace/audit-pack/.claude/skills/docs-audit
Command: npx skills add https://github.com/me2resh/apexyard --skill docs-audit-me2resh

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps teams identify documentation gaps and staleness by evaluating whether your docs are organized according to the Diataxis framework and whether key guidance stays accurate over time.

Core Features & Use Cases

  • Diataxis quadrant coverage checks: Verifies tutorials, how-to guides, reference material, and explanation docs are present and meaningfully covered.
  • README and operational documentation review: Assesses minimum README quality plus deployment, runbook, changelog, and architecture/decision documentation.
  • Staleness detection and consistency flags: Flags outdated stack references and mismatches between docs and current code/features.
  • Audit output + persisted trends: Produces a structured findings table and persists results to enable cross-run trend tracking.

Quick Start

Run the docs audit for a target project path like 'projects/my-app'.

Frequently Asked Questions about docs-audit

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

FAQPage Schema
How do I audit documentation completeness using the Diataxis framework?

You can audit documentation completeness by checking coverage across all four Diataxis quadrants: tutorials, how-to guides, reference material, and explanation docs. This verifies that each documentation type is present and meaningfully covered.

What is the best way to detect stale API documentation and outdated references?

Detecting stale API documentation involves comparing last-modified timestamps against recent code changes to identify mismatches. This flags outdated stack references and operational guidance that have drifted from the current implementation.

How do I check if my README and operational documentation are ready for release?

Checking release readiness involves assessing minimum README quality alongside operational documentation like deployment guides, runbooks, changelogs, and architecture decisions. This validates that essential guidance is present before deployment.

Does a documentation audit work for ongoing maintenance and project onboarding?

A documentation audit works for both project onboarding and ongoing maintenance by evaluating SDLC readiness. It identifies missing operational guidance and detects when existing docs have drifted from implementation due to code changes.

What is included in a documentation audit output for tracking staleness over time?

A documentation audit output includes a structured findings table detailing coverage gaps and staleness flags. Results are persisted to enable cross-run trend tracking, helping monitor documentation freshness across repeated audits.