documentation-review

Orchestrate multi-stage documentation reviews covering build, structure, accuracy, and style.

29|22|Updated Nov 25, 2025
One-click install
npx skills add https://github.com/canonical/copilot-collections --skill documentation-review-canonical
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: documentation-review
Source: https://github.com/canonical/copilot-collections/tree/main/assets/skills/documentation-review
Command: npx skills add https://github.com/canonical/copilot-collections --skill documentation-review-canonical

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automates the comprehensive review of project documentation, ensuring it is buildable, structurally sound, accurate, and adheres to style guidelines.

Core Features & Use Cases

  • Build Validation: Checks if documentation builds successfully.
  • Structure Audit: Verifies organizational consistency and navigation.
  • Accuracy Verification: Cross-references content with source code.
  • Style Compliance: Enforces project style guide adherence.
  • Use Case: Before merging a documentation update, use this skill to perform an automated audit, catching potential errors in build, structure, accuracy, or style.

Quick Start

Run the documentation-review skill to audit the documentation in the 'docs/' directory.

Frequently Asked Questions about documentation-review

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

FAQPage Schema
How do I automate a documentation audit against my project's style guide?

To automate a documentation audit, run a multi-stage review process that verifies build validation, structural analysis, accuracy against source code, and style guide compliance, synthesizing the findings into a consolidated report.

How do I verify documentation accuracy against source code automatically?

You verify documentation accuracy automatically by running a review process that cross-references your documentation content directly with the source code, identifying discrepancies and outputting a synthesized report of accuracy issues.

Can I check if my documentation adheres to the Diataxi framework?

Yes, you can check Diataxi framework adherence by running an automated structural analysis that verifies your documentation organization matches the framework's principles, including the synthesized report details on structural compliance.

Does this documentation review process validate build success?

Yes, the documentation review process explicitly includes build validation as its first stage, checking if the documentation builds successfully before proceeding to structural analysis, accuracy verification, and style compliance.

What is the best way to enforce style guide compliance in technical documentation?

The best way to enforce style guide compliance is using an automated multi-stage review that checks adherence against predefined project style guidelines, consolidating any style violations into a structured report for resolution.

When should I perform a documentation review before merging changes?

You should perform a documentation review before merging any documentation update to catch potential errors in build, structure, accuracy, or style, ensuring the docs directory remains compliant and structurally sound.