docs-audit

Audit markdown documentation against the current codebase state.

6|1|Updated Jan 22, 2026
One-click install
npx skills add https://github.com/outfitter-dev/outfitter --skill docs-audit-outfitter-dev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docs-audit
Source: https://github.com/outfitter-dev/outfitter/tree/main/plugins/fieldguides/skills/docs-audit
Command: npx skills add https://github.com/outfitter-dev/outfitter --skill docs-audit-outfitter-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the common issue of outdated, inaccurate, or incomplete documentation that can lead to user confusion, incorrect implementation, and wasted development time.

Core Features & Use Cases

  • Comprehensive Auditing: Checks markdown files for accuracy, link validity, code example correctness, and docstring coverage against the current codebase.
  • Prioritized Analysis: Focuses on stale or recently changed documentation, ensuring the most critical areas are reviewed first.
  • Use Case: Before releasing a new feature, run this Skill to automatically audit all related documentation, ensuring code examples work, links are valid, and API descriptions match the implementation.

Quick Start

Run the docs-audit skill to perform a comprehensive documentation audit of the entire repository.

Frequently Asked Questions about docs-audit

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

FAQPage Schema
How do I check if my markdown documentation is accurate against the current codebase?

A documentation audit checks markdown files against the codebase to validate accuracy, code examples, and API signatures. This process identifies outdated information and ensures technical docs match the current implementation.

What does a documentation audit check for in markdown files?

A documentation audit evaluates markdown files for link validity, code example correctness, CLI command accuracy, and docstring coverage. It ensures all documented configurations and signatures match the current codebase state.

How do I validate internal and external links in markdown documentation?

You validate links by running a documentation audit that checks internal and external link validity across markdown files. This discovers broken references and ensures documentation links remain active and correctly targeted.

How do I verify code examples and CLI commands in my documentation still work?

You verify code examples by auditing documentation against the current codebase state. This validates function signatures, configuration examples, and CLI command syntax to ensure documented code matches the actual implementation.

Can I prioritize documentation audits for recently changed files?

Yes, documentation audits can prioritize recently changed or stale files. This efficient discovery strategy focuses analysis on critical areas first, ensuring the most updated features receive priority review before release.

Does documentation auditing check docstring coverage in the codebase?

Yes, documentation auditing checks docstring coverage alongside markdown validation. It verifies functions have adequate docstrings and ensures API descriptions match actual implementation signatures in the codebase.