doc-audit-existing

Audit existing documentation against Diátaxis framework best practices and generate reports.

3|1|Updated Apr 18, 2021
One-click install
npx skills add https://github.com/nashgao/mqtt-client --skill doc-audit-existing
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doc-audit-existing
Source: https://github.com/nashgao/mqtt-client/tree/main/.claude/skills/doc/doc-audit-existing
Command: npx skills add https://github.com/nashgao/mqtt-client --skill doc-audit-existing

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill addresses the challenge of maintaining high-quality, comprehensive, and user-friendly documentation by automating the audit and improvement process.

Core Features & Use Cases

  • Comprehensive Auditing: Analyzes documentation structure, content quality, and adherence to best practices.
  • Actionable Recommendations: Provides specific, prioritized suggestions for improvement, including rewritten sections.
  • Use Case: A project manager can use this Skill to ensure their team's technical documentation is clear, complete, and easy for new developers to follow, reducing onboarding time and support requests.

Quick Start

Run the doc-audit-existing command to audit the documentation in the ./docs/ directory.

Frequently Asked Questions about doc-audit-existing

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

FAQPage Schema
How do I audit existing technical documentation against best practices?

To audit existing technical documentation, you can use an automated tool to analyze structural and content gaps, check Diátaxis framework compliance, assess readability, and generate detailed reports with actionable recommendations.

What is the Diátaxis framework and how does it improve technical writing?

The Diátaxis framework is a documentation structure approach that categorizes content into tutorials, how-to guides, reference, and explanation. Auditing documentation against it ensures logical content organization and improves user experience.

How do I identify and fix content gaps in open-source documentation?

To identify and fix content gaps in open-source documentation, run an automated audit to detect missing sections, poor readability, or weak examples, then apply provided rewritten sections and prioritized recommendations.

Can I automatically rewrite documentation sections to improve readability and example quality?

Yes, an automated documentation audit can provide actionable recommendations that include rewritten sections, specifically targeting readability improvements and higher quality code examples for open-source projects.

What's the best way to reduce developer onboarding time through documentation improvement?

The best way to reduce developer onboarding time is to audit your documentation for completeness and clarity, ensuring it adheres to best practices and provides clear, easy-to-follow technical writing for new developers.

Does this documentation audit tool work with existing docs directories without extra dependencies?

Yes, the documentation audit tool operates directly on your existing ./docs/ directory without requiring any external dependencies, analyzing your current content and structure to generate improvement reports.