How does this skill handle outdated diagrams?

It identifies diagram drift where class diagrams, data flows, or component maps no longer match the actual code structures or fields.

Why is documentation health important for AI agents?

AI agents rely on repository documentation as a source of truth; stale or incorrect docs are worse than no docs because they cause agents to make wrong decisions.

What is the difference between the Verifier and Gardener roles?

The Verifier checks if new changes were documented post-build to confirm the builder did its duty, while the Gardener maintains the health of the entire documentation tree at any time.

Can this skill find broken links in my docs?

Yes, it audits cross-link integrity to ensure plans link to architecture, living docs are indexed, and all references point to existing files.

Documentation Health & Audit Guard

Name: Documentation Health & Audit Guard
Author: JSai23

byJSai23

•

内容管理

Audits repository documentation for accuracy, structural integrity, and architectural alignment after build cycles.

This knowledge skill prevents documentation rot by identifying stale content, broken diagrams, and misleading architectural guides within a repository. It operates in two specialized modes: the 'Verifier' mode ensures new changes are properly documented immediately after a build, while the 'Gardener' mode provides a broader scope for maintaining the entire documentation tree. By prioritizing the correction of actively misleading information, it ensures that both AI agents and human developers can rely on the repository as a true source of technical authority.

主要功能

01Status tracking for project plans to prune completed or stale tasks

02Automated drift detection for architectural diagrams and data flows

03Priority-based reporting to address misleading documentation first

04Validation of ARCHITECTURE.md against current code modules and dependencies

051 GitHub stars

06Cross-link integrity checks between design docs, project plans, and code

使用场景

01Post-build verification to ensure new features are reflected in living documentation

02Repository-wide documentation gardening to fix broken links and orphaned files

03Architectural audits to ensure diagrams match current system implementation

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jsai23/claude-tooling common-doc-audit-k

For use in Claude.ai and ChatGPT

Download Skill