readme-audit

Audit and fix README.md and AGENTS.md for consistency with repository contents.

1|Updated Mar 9, 2026
One-click install
npx skills add https://github.com/oscardlfr/AndroidCommonDoc --skill readme-audit-oscardlfr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: readme-audit
Source: https://github.com/oscardlfr/AndroidCommonDoc/tree/main/skills/readme-audit
Command: npx skills add https://github.com/oscardlfr/AndroidCommonDoc --skill readme-audit-oscardlfr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps maintain up-to-date and accurate README.md and AGENTS.md files, ensuring all information aligns with the current state of the repository.

Core Features & Use Cases

  • Audit Documentation: Checks for stale counts, missing table entries, and more.
  • Automated Fixing: Applies corrections to documentation with the --fix flag.
  • Use Case: Before closing a milestone or when the documentation feels outdated, use this Skill to verify and update the README and AGENTS files.

Quick Start

Run /readme-audit to perform an audit. Use /readme-audit --fix to apply automatic corrections.

Frequently Asked Questions about readme-audit

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

FAQPage Schema
How do I audit and fix discrepancies in my repository's README.md and AGENTS.md files?

To audit README.md and AGENTS.md files, run the audit tool to check for stale counts, missing table entries, and other discrepancies against the current repository contents, ensuring your documentation accurately reflects the project state.

What is the best way to keep project documentation consistent with repository contents?

Keeping project documentation consistent involves running an automated documentation audit that checks for missing rows and outdated count headers in README and AGENTS files, then applying corrections to align the text with the actual repository structure.

How do I automatically update stale file counts and missing table entries in my README?

You can automatically update stale file counts and missing table entries in your README by running an audit command with a fix flag, which detects discrepancies between the documentation and repository contents and applies the necessary corrections.

When should I run a documentation audit on my software project?

You should run a documentation audit on your software project before closing a milestone or whenever the documentation feels outdated, ensuring that all information in the README and AGENTS files aligns with the current state of the repository.

Can I automatically correct outdated documentation without manually editing the files?

Yes, you can automatically correct outdated documentation without manual edits by executing the audit tool with an automated fixing flag, which applies corrections directly to the README and AGENTS files to resolve detected discrepancies.

Does the documentation audit work for both README.md and AGENTS.md files?

Yes, the documentation audit works for both README.md and AGENTS.md files, checking both documents for consistency with the repository contents and handling missing rows, count headers, and other discrepancies across both files.