util-docs-audit

Audit repository documentation for staleness, broken references, and deprecated API usage.

Updated Apr 8, 2026
One-click install
npx skills add https://github.com/VictorHueni/homemade-claude-kit --skill util-docs-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: util-docs-audit
Source: https://github.com/VictorHueni/homemade-claude-kit/tree/main/skills/util-docs-audit
Command: npx skills add https://github.com/VictorHueni/homemade-claude-kit --skill util-docs-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps identify outdated, stale, and dead documentation within a repository, ensuring that the documentation remains accurate and up-to-date.

Core Features & Use Cases

  • Documentation Audit: Scan all documentation files for staleness, broken references, and outdated content.
  • Code-to-Doc Drift Analysis: Compare documentation against code changes to identify discrepancies.
  • Content Quality Checks: Identify TODO markers, placeholders, and deprecated API usage.
  • Use Case: Regularly use this Skill to maintain the quality of your project's documentation, ensuring it aligns with the current state of the codebase.

Quick Start

Run the util-docs-audit skill to scan the documentation for any issues.

Frequently Asked Questions about util-docs-audit

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

FAQPage Schema
How do I detect documentation drift against code changes in a repository?

Documentation drift is detected by comparing documentation files against code changes to identify discrepancies. This analysis scans for outdated content, deprecated API usage, and broken references caused by code modifications.

What is the best way to audit documentation for broken references and stale content?

Auditing documentation for broken references and stale content involves scanning all documentation files to identify outdated information, dead links, and placeholder TODO markers. This ensures repository documentation remains accurate and up-to-date.

Can I check for deprecated API usage in markdown documentation automatically?

Yes, you can check for deprecated API usage in markdown documentation automatically. The audit scans documentation files to flag outdated API references and content quality issues like placeholders or TODO markers.

Do I need Python to run a documentation freshness and accuracy scan?

Yes, Python is required to run a documentation freshness and accuracy scan. The Skill relies on Python scripts to perform the repository analysis, detect code-to-doc drift, and generate the final audit reports.

What types of content quality issues does a repository documentation audit identify?

A repository documentation audit identifies content quality issues such as TODO markers, placeholders, stale information, and deprecated API usage. It also detects broken references and dead documentation within the codebase.

When should I scan my repository for outdated and dead documentation?

You should scan your repository for outdated and dead documentation regularly to maintain quality. Running the audit after significant codebase updates ensures documentation aligns with the current state of the code and prevents drift.