dotagent:doc-review

Audit dotagent documentation for drift and generate a punch list of stale references.

3|1|Updated May 19, 2026
One-click install
npx skills add https://github.com/avelino/dotagent --skill dotagent-doc-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dotagent:doc-review
Source: https://github.com/avelino/dotagent/tree/main/.claude/skills/doc-review
Command: npx skills add https://github.com/avelino/dotagent --skill dotagent-doc-review

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Documentation drift happens when code or behavior changes without corresponding updates to user-facing docs, leading to misinformation and confusion. This skill detects drift, surfaces it for remediation, and prevents outdated guidance from being considered complete.

Core Features & Use Cases

  • Audits documentation surfaces impacted by user-visible changes (manifests, plugins, environment variables, events, and file paths) and flags drift.
  • Generates a punch list of stale, renamed, or moved docs with exact lines or sections to update.
  • Prevents silent passes by enforcing remediation before reporting a task as done.

Quick Start

Review a change to dotagent and run the doc-review audit to surface stale docs before marking as done.

Frequently Asked Questions about dotagent:doc-review

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

FAQPage Schema
How do I catch documentation drift after updating manifest schemas or CLI commands?

To catch documentation drift after updating manifest schemas or CLI commands, audit your user-visible code changes to surface stale references and generate a remediation punch list. This prevents outdated guidance from being marked as complete.

What is documentation drift and how do I find moved file paths or renamed plugins?

Documentation drift occurs when code changes without corresponding user-facing updates. You find moved file paths or renamed plugins by auditing documentation surfaces impacted by user-visible behavior changes to flag exact lines needing updates.

How do I validate frontmatter presence and fix outdated environment variable references?

You validate frontmatter presence and fix outdated environment variable references by running a documentation review audit that enforces frontmatter requirements and flags stale references with exact lines for actionable remediation.

Does the documentation review process prevent silent passes when auditing plugin protocols?

Yes, the documentation review process prevents silent passes when auditing plugin protocols by enforcing remediation of stale or moved references before allowing a task to be reported as done, ensuring no outdated guidance slips through.

What's the best way to audit documentation surfaces impacted by new events or environment variables?

The best way to audit documentation surfaces impacted by new events or environment variables is to apply a review process across all user-visible changes, returning a punch list of stale references with exact lines and actionable remediation guidance.