documentation-style

Validate documentation against style guides and MyST/reST syntax.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill enforces adherence to a project's documentation style guide, ensuring consistency in tone, voice, terminology, and formatting across all documentation.

Core Features & Use Cases

  • Style Guide Compliance: Validates documentation against a comprehensive style guide, including tone, voice, and terminology.
  • Syntax Checking: Verifies MyST/reST syntax for proper formatting of headings, lists, code blocks, etc.
  • Violation Citation: Provides specific quotes from the style guide for every identified violation.
  • Use Case: When reviewing a new set of documentation, use this Skill to automatically check for adherence to the company's official style guide and flag any deviations with clear references to the rules.

Quick Start

Use the documentation-style skill to review the documentation file 'README.md' for style guide compliance.

Frequently Asked Questions about documentation-style

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

FAQPage Schema
How do I check my markdown documentation for style guide compliance?

To enforce style guide compliance in documentation, validate text against a normative style asset to check tone, voice, terminology, and formatting. The system flags deviations and cites specific quoted passages from the style guide for every identified violation.

Can I validate MyST and reST syntax for formatting errors?

Yes, you can validate MyST and reST syntax to ensure proper formatting of headings, lists, and code blocks. The review process fetches syntax-specific guides at runtime to verify that your documentation structure adheres to these formatting standards.

Do I need a normative style asset to review documentation tone and voice?

Yes, a normative style asset is required to review documentation tone and voice. The validation process depends on this reference asset to enforce consistency and cite specific style guide violations with quoted passages during the content review.

How do I get specific references for terminology violations in content review?

To get specific references for terminology violations during a content review, use a validation tool that cites the exact rules broken. It provides specific quotes from the project style guide for every identified formatting or terminology deviation.

What is the best way to ensure consistent formatting across project documentation?

The best way to ensure consistent formatting across project documentation is to enforce adherence to a comprehensive style guide. Automatically validating files against these rules ensures consistent tone, voice, and punctuation across all content.