Documentation Quality

Audit documentation quality across structure, accuracy, and maintainability.

Updated Feb 9, 2026
One-click install
npx skills add https://github.com/nsalvacao/nsalvacao-claude-code-plugins --skill documentation-quality
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Documentation Quality
Source: https://github.com/nsalvacao/nsalvacao-claude-code-plugins/tree/main/plugins/solution-audit/skills/documentation-quality
Command: npx skills add https://github.com/nsalvacao/nsalvacao-claude-code-plugins --skill documentation-quality

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Documentation quality assessments ensure docs are not just present but actually helpful, accurate, and maintainable, reducing confusion and trapped knowledge.

Core Features & Use Cases

  • Classify documentation assets (tutorials, how-to guides, reference, explanation) and map to appropriate workflows.
  • Check README utility, installation clarity, quick-start effectiveness, and overall navigability.
  • Verify doc-to-code alignment, configuration and API references, and correctness of examples.
  • Assess documentation hierarchy and leverage for long-term maintenance to reduce debt.

Quick Start

Provide a repository and request a documentation quality audit to generate a structured report.

Frequently Asked Questions about Documentation Quality

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

FAQPage Schema
How do I audit documentation quality for a project repository?

To audit documentation quality, provide a repository to evaluate usefulness, accuracy, structure, and maintainability. The process generates a structured report covering asset classification, link integrity, code-to-doc alignment, and readability across all project docs.

What does a documentation quality audit include beyond checking if docs exist?

A documentation quality audit goes beyond existence checking to evaluate asset classification, README utility, link integrity, example validation, hierarchy assessment, documentation debt detection, and quality writing evaluation for long-term maintainability.

How do I verify doc-to-code alignment and API reference correctness?

Verifying doc-to-code alignment involves checking configuration and API references against the actual codebase, validating the correctness of examples, and ensuring the documentation accurately reflects current implementation behavior.

Can I use this documentation audit for multi-format content and user guides?

Yes, the documentation audit is applicable to multi-format content including READMEs, API references, user guides, tutorials, how-to guides, and explanation docs across various project types and workflows.

What is the best way to detect and reduce documentation debt in a repository?

The best way to reduce documentation debt is assessing documentation hierarchy and leverage for long-term maintenance, detecting outdated assets, and evaluating readability to ensure docs remain accurate, useful, and maintainable over time.