How does the Documentation Specialist detect drift?

It builds an inventory of documented items and compares them against actual code signatures and public interfaces to flag partial matches, missing docs, or undocumented code.

What kind of documentation can it generate?

It can generate a wide range of documents including project READMEs, API references, database model docs, UI component guides, and architecture decision records (ADR).

Does it validate code examples within the documentation?

Yes, part of the quality checklist includes testing and verifying that code examples are technically accurate and match the current implementation.

Can I use custom templates with this skill?

Yes, the skill includes a template system for various documentation types like APIs, models, and guides that can be applied and extended consistently across your project.

How do I fix documentation that has fallen out of sync?

You can use the /docs-specialist:sync fix command to automatically align your documentation with the current state of the source code and its public interfaces.

Documentation Specialist

Name: Documentation Specialist
Author: mwguerra

bymwguerra

•

Content Management

Automates technical documentation workflows by generating docs from code, detecting implementation drift, and enforcing quality standards.

The Documentation Specialist skill transforms how teams manage technical documentation by bridging the gap between implementation and reference materials. It analyzes source code structure and comments to generate accurate documentation automatically while identifying discrepancies (drift) when code changes outpace its description. With a robust template system for APIs, models, and architecture records, it ensures consistency and high technical accuracy across entire projects, making it indispensable for maintaining living documentation that stays relevant as the codebase evolves.

Key Features

01Built-in diagnostic tools to repair broken links and fix documentation structure

02Comprehensive validation for link integrity, code example accuracy, and technical completeness

0322 GitHub stars

04Automated code-to-docs generation using AST parsing and signature extraction

05Extensible template system for project READMEs, API endpoints, architecture records, and more

06Real-time drift detection to identify discrepancies between code and existing documentation

Use Cases

01Standardizing documentation structure and formatting across a multi-repository organization

02Auditing legacy documentation to find and fix outdated implementation details

03Generating comprehensive API and component documentation for new or existing codebases

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add mwguerra/claude-code-plugins docs-specialist

For use in Claude.ai and ChatGPT

Download Skill