Documentation Freshness Audit

Audit documentation freshness by comparing modification dates against code changes.

Updated Feb 13, 2026
One-click install
npx skills add https://github.com/cdalsoniii/brightpath-coder --skill documentation-freshness-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Documentation Freshness Audit
Source: https://github.com/cdalsoniii/brightpath-coder/tree/main/.cursor/skills/documentation-freshness
Command: npx skills add https://github.com/cdalsoniii/brightpath-coder --skill documentation-freshness-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses the common issue of outdated or missing documentation, which can lead to confusion, errors, and a poor developer or user experience.

Core Features & Use Cases

  • Stale README Detection: Identifies documentation that hasn't been updated since the last code change.
  • Orphaned Reference Checking: Finds documentation pointing to code or features that no longer exist.
  • Missing Documentation Identification: Flags new code or features that lack corresponding documentation.
  • Link Validation: Checks for broken internal and external links within documentation.
  • Use Case: Before a major release, run this audit to ensure all new features are documented and existing documentation accurately reflects the codebase, preventing support issues and improving onboarding.

Quick Start

Run the documentation freshness audit for the entire project.

Frequently Asked Questions about Documentation Freshness Audit

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

FAQPage Schema
How do I check if my documentation is out of sync with code changes?

A documentation freshness audit compares document modification dates against corresponding code changes to identify stale, orphaned, or missing documentation. This ensures your documentation accurately reflects the current codebase.

What is the best way to find stale README files before a release?

Auditing documentation freshness identifies stale README files by checking if they have been updated since the last code change. Running this audit before a major release verifies all new features are documented and existing documentation is accurate.

How do I find orphaned documentation pointing to removed code features?

An orphaned reference audit checks markdown files and API specifications to locate documentation pointing to code or features that no longer exist. This prevents user confusion and support issues.

Can I validate broken links in markdown and API specifications automatically?

Validating broken links in markdown and API specifications is done by running a documentation audit. The audit checks internal and external links across documentation files to ensure overall accuracy.

How do I identify missing documentation for new code?

Identifying missing documentation for new code involves an audit that flags new code or features lacking corresponding documentation. This ensures complete documentation coverage for onboarding and release preparation.