docs-standards

Enforce Microsoft Style Guide and squad documentation patterns across content.

66|41|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/olivomarco/vbd-copilot --skill docs-standards-olivomarco
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docs-standards
Source: https://github.com/olivomarco/vbd-copilot/tree/main/.copilot/skills/docs-standards
Command: npx skills add https://github.com/olivomarco/vbd-copilot --skill docs-standards-olivomarco

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Squad documentation often suffers from inconsistent tone, structure, and formatting. This skill enforces Microsoft Style Guide standards plus squad-specific conventions to improve clarity, readability, and discoverability across documentation assets.

Core Features & Use Cases

  • Enforces title casing, active voice, present tense, sentence-case headings, and avoidance of ampersands in prose.
  • Provides formatting patterns for scannability: concise paragraphs, bullets, and cross-references at the bottom.
  • Use Case: When preparing API docs, getting-started guides, or scenario pages, apply these standards to ensure consistent quality and faster reviews.

Quick Start

Apply Microsoft Style Guide and squad conventions to your first draft.

Frequently Asked Questions about docs-standards

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

FAQPage Schema
How do I enforce Microsoft Style Guide standards in my API documentation?

You can enforce Microsoft Style Guide standards in API documentation by applying automated checks for frontmatter presence, sentence-case headings, active voice, and correct cross-reference formatting to ensure consistency and readability.

What is the best way to standardize getting-started guides for consistent tone and structure?

The best way to standardize getting-started guides is to apply rules for title casing, present tense, and scannable formatting like concise paragraphs and bullets, ensuring consistent tone and faster reviews across squad content.

How do I validate frontmatter and heading style in technical scenario pages?

Validate frontmatter and heading style in scenario pages by checking documentation patterns against squad-specific conventions, verifying frontmatter presence, sentence-case headings, and the avoidance of ampersands in prose.

Does this documentation style guide check for formatting and cross-reference rules?

Yes, this documentation style guide checks for formatting and cross-reference rules by validating scannability patterns like concise paragraphs and bullets, and ensuring cross-references are correctly placed at the bottom of the content.

Can I use this approach to improve readability across all squad documentation assets?

Yes, you can use this approach to improve readability across squad documentation assets by enforcing consistent structure, tone, and formatting standards across getting-started guides, API docs, and scenario pages.

When do I need to apply squad-specific documentation patterns to my content?

You need to apply squad-specific documentation patterns to your content when preparing drafts of API docs, getting-started guides, or scenario pages to ensure consistent quality, structure, and discoverability across assets.