What is the benefit of using this for CLAUDE.md?

CLAUDE.md provides critical context for AI agents. Keeping it updated ensures that AI tools follow the latest project conventions, commands, and structures.

How does the skill ensure documentation accuracy?

The agent validates every claim, file path, and API reference against the actual source code to ensure that the documentation matches the current implementation.

Can I run the Docs skill automatically after a code change?

Yes, the Docs skill can be invoked standalone or as part of a larger workflow like /work to document changes immediately after they are committed.

What documentation types does the Docs skill support?

It supports a wide range of surfaces including README files, CLAUDE.md, API documentation (JSDoc/TSDoc), architecture guides, and inline code comments.

Does it create documentation for features that don't exist yet?

No, the skill follows a strict rule to never document features that haven't been implemented, ensuring the documentation remains a source of truth.

Documentation Auditor & Generator

Name: Documentation Auditor & Generator
Author: automagik-dev

byautomagik-dev

•

306

•

Content Management

Audits, generates, and validates technical documentation against the codebase to ensure accuracy and eliminate stale references.

The Docs skill is a specialized subagent designed to maintain high-quality, synchronized documentation for complex projects. It scans multiple surfaces—including READMEs, API guides, and the critical CLAUDE.md file—to identify gaps, missing modules, or outdated workflows. By cross-referencing every documentation claim directly with the source code, it ensures that file paths, API contracts, and usage examples are factually correct, preventing documentation rot and providing reliable context for both humans and AI agents.

Key Features

01Detailed validation reporting to confirm documentation accuracy

02First-class support for maintaining CLAUDE.md project conventions

03Comprehensive auditing of READMEs, API docs, and architecture guides

04306 GitHub stars

05Automated identification of documentation gaps based on codebase analysis

06Real-time validation of all technical claims against the live source code

Use Cases

01Maintaining up-to-date CLAUDE.md files to improve AI agent performance and accuracy

02Synchronizing documentation immediately after a major code refactor or feature release

03Onboarding new developers by generating a comprehensive map of undocumented modules

Key Features

01Detailed validation reporting to confirm documentation accuracy

02First-class support for maintaining CLAUDE.md project conventions

03Comprehensive auditing of READMEs, API docs, and architecture guides

04306 GitHub stars

05Automated identification of documentation gaps based on codebase analysis

06Real-time validation of all technical claims against the live source code

Use Cases

01Maintaining up-to-date CLAUDE.md files to improve AI agent performance and accuracy

02Synchronizing documentation immediately after a major code refactor or feature release

03Onboarding new developers by generating a comprehensive map of undocumented modules