docs-audit

Markdown documentation auditing detects broken links, content duplication, verbosity, and inefficient token usage across large documentation sets. It validates relative paths and cross-refs, flags overly long sections, and identifies time-sensitive data to recommend indexing for better token economy.

You can audit markdown docs across large documentation sets including knowledge bases and references/ directories. The process supports batch processing with Grep and Read tools, making it suitable for checking extensive file collections before reviews or long sessions.

Markdown auditing distinguishes itself by combining link validation, redundancy detection, verbosity control, and token economy guidance in a single pass. Unlike basic link checkers, it identifies duplicated content and conflicting statements across docs while recommending indexing for time-sensitive data.

Markdown auditing is limited to text-based analysis of documentation files and cannot execute or validate code snippets dynamically. It focuses on detecting broken links, verbosity, redundancy, and token economy issues, producing recommendations rather than automatically rewriting or fixing the content.