docs-standards

Enforce Microsoft Style Guide documentation standards across squads.

3|3|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/quaid-app/quaid --skill docs-standards-quaid-app
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docs-standards
Source: https://github.com/quaid-app/quaid/tree/main/.copilot/skills/docs-standards
Command: npx skills add https://github.com/quaid-app/quaid --skill docs-standards-quaid-app

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Inconsistent documentation and divergent writing patterns across squads hinder clarity and discoverability. This Skill provides a standardized baseline by combining the Microsoft Style Guide with squad-specific conventions to improve readability and cohesion.

Core Features & Use Cases

  • Enforces title case rules, active voice, present tense, and second-person narration to maintain uniform tone.
  • Defines squad-wide formatting patterns for scannability, warnings, cross-references, and content structure.
  • Provides a structured page blueprint: Title (H1), warning/callout, "Try this" prompts, overview, and content sections to ensure predictable page layout.

Quick Start

Audit an existing documentation page and rewrite it to conform to the Microsoft Style Guide and squad conventions.

Frequently Asked Questions about docs-standards

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

FAQPage Schema
How do I enforce consistent documentation tone and structure across multiple squads?

To enforce consistent documentation across squads, apply a standardized style guide baseline combined with squad-specific conventions. This ensures uniform headings, active voice, and second-person narration, resolving divergent writing patterns and improving content readability and discoverability.

What is the Microsoft Style Guide baseline for technical documentation?

The Microsoft Style Guide baseline for technical documentation is a set of rules enforcing title case, active voice, present tense, and second-person narration. It establishes uniform tone and formatting patterns for scannability, warnings, and cross-references to maintain content clarity and cohesion.

How do I audit and rewrite an existing documentation page to meet style guide conventions?

To audit and rewrite an existing documentation page, evaluate it against style guide conformance rules and rewrite it to enforce required frontmatter metadata, title case, and a defined page structure including a title, warning, overview, and content sections.

Does this documentation standardization approach work for onboarding pages and scenario documentation?

Yes, this documentation standardization approach works for onboarding pages and scenario documentation. It applies a structured page blueprint with predictable layouts, including H1 titles, callouts, "Try this" prompts, and content sections, ensuring consistency across various technical guide formats.

What are the required frontmatter metadata and page structure elements for squad-wide documentation?

Required frontmatter metadata and page structure elements for squad-wide documentation include an H1 title, warning or callout sections, "Try this" prompts, an overview, and defined content sections. These elements ensure predictable page layouts and conformance to established style guidelines.