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.