Documentation Audit Skill

Audit documentation files against the current codebase state, checking for accuracy, completeness, and freshness.

Workflow

Stage 1: Discovery

Run the discovery script to get a manifest of all markdown files with git metadata:

bun "$(dirname "$0")/scripts/discover-docs.ts" ${path ? `--path "${path}"` : ""} --limit 50 --sort staleness

Parse the JSON output to understand:

• Total documentation files in scope
• Activity status distribution (active/recent/idle/stale/ancient)
• Files with related code changes (potential staleness indicators)