Does it automatically apply fixes to my documents?

The doc-doctor skill is primarily for diagnosis and reporting. To apply fixes, you can use related skills in the marketplace-bundles-pm-documents package like /doc-maintain.

Can I run this on my entire project at once?

Yes, by specifying a directory as a target, the skill will use glob patterns to find and analyze all .adoc files while ignoring irrelevant folders like node_modules.

What is the difference between the diagnostic depths?

Quick depth validates formatting only; Standard depth adds link verification; Thorough depth includes format, links, and a comprehensive content review.

What file formats does Documentation Doctor support?

Documentation Doctor is specifically optimized for AsciiDoc (.adoc) files, providing deep analysis for this specific markup language.

Is this part of the Plan Marshall orchestration layer?

Yes, it is a specialized tool within the Plan Marshall framework designed to enforce consistency and reliability in AI-generated documentation.

Documentation Doctor

Name: Documentation Doctor
Author: cuioss

bycuioss

•

Content Management

Diagnoses and reports formatting, link, and content issues in AsciiDoc documentation to ensure high-quality technical content.

Documentation Doctor is a specialized diagnostic skill for Claude Code designed to audit and maintain AsciiDoc files. Operating as part of the Plan Marshall orchestration layer, it provides a structured approach to documentation health by offering three levels of inspection: quick format validation, standard link verification, and thorough content reviews. Whether you are checking a single file or an entire repository, this skill generates detailed reports that categorize issues, helping developers and technical writers maintain professional, error-free documentation with minimal manual effort.

Key Features

01Structured diagnostic reporting with per-file issue tracking

021 GitHub stars

03Batch processing with intelligent directory globbing

04Comprehensive internal and external link verification

05Three-tier diagnostic depth (Quick, Standard, Thorough)

06Automated AsciiDoc syntax and format validation

Use Cases

01Performing pre-release audits on project documentation to catch broken links

02Ensuring style and format consistency across large sets of technical manuals

03Validating documentation structure during automated CI/CD workflows

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add cuioss/plan-marshall doc-doctor

For use in Claude.ai and ChatGPT

Download Skill