documentation-review

Review documentation files for consistency, correctness, and drift.

9|1|Updated Jul 9, 2025
One-click install
npx skills add https://github.com/KemingHe/common-devx --skill documentation-review-keminghe
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: documentation-review
Source: https://github.com/KemingHe/common-devx/tree/main/.agents/skills/documentation-review
Command: npx skills add https://github.com/KemingHe/common-devx --skill documentation-review-keminghe

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps maintainers and writers detect and correct documentation drift, broken links, unfilled placeholders, version mismatches, and formatting or linter issues so documentation stays reliable and onboarding friction is reduced.

Core Features & Use Cases

  • Consistency checks: detect version drift, naming mismatches, and template deviations across related files.
  • Correctness checks: validate YAML/frontmatter, verify links and file paths, and flag unfilled placeholders like [TODO] or [TBD].
  • Reporting and prioritization: generate a structured findings table that classifies issues as critical or minor and includes linter errors when tooling is available.
  • Use cases: pre-commit audits, PR/MR documentation reviews, and bulk audits of docs directories.

Quick Start

Ask the agent to review the files in path docs/ for consistency, correctness, and linter errors and return a prioritized structured findings table.

Frequently Asked Questions about documentation-review

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

FAQPage Schema
How do I audit markdown documentation for consistency and broken links?

To audit markdown documentation for consistency, review files to detect drift, verify links and file paths, and flag unfilled placeholders like [TODO]. This generates a prioritized findings table highlighting critical issues and linter errors first.

Can I check mdx and rst files for documentation drift in a pull request?

Yes, you can check mdx, rst, and plain text files for documentation drift within a pull or merge request. The review validates YAML frontmatter, detects version mismatches, and produces a structured findings table for pre-commit checks.

What is the best way to lint documentation directories before committing?

The best way to lint documentation directories before committing is to run a bulk audit that checks formatting, naming mismatches, and template deviations. It classifies issues as critical or minor and includes linter errors when tooling is available.

Does documentation review work on plain text files or only markdown?

Documentation review works on plain text files as well as markdown, mdx, and rst formats. It limits changes to documentation formats only, ensuring version drift and unfilled placeholders are flagged without altering code.

How do I generate a prioritized findings table for documentation issues?

You generate a prioritized findings table for documentation issues by reviewing files for correctness and consistency. The table classifies issues as critical or minor, highlights critical issues first, and includes linter errors when tooling is available.