docs-standards

Enforces Microsoft Style Guide and Squad formatting conventions in documentation.

1|Updated Jul 7, 2026
One-click install
npx skills add https://github.com/seiggy/maf-copilot-studio-demo --skill docs-standards-seiggy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docs-standards
Source: https://github.com/seiggy/maf-copilot-studio-demo/tree/main/.squad/templates/skills/docs-standards
Command: npx skills add https://github.com/seiggy/maf-copilot-studio-demo --skill docs-standards-seiggy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Documentation written by multiple contributors drifts in tone, heading style, and structure, which hurts readability and breaks automated doc tests. This Skill provides a single reference for Microsoft Style Guide rules plus Squad-specific formatting patterns so every page stays consistent. ## Core Features & Use Cases - Style rule enforcement: Sentence-case headings, active voice, second person, present tense, and no ampersands in prose. - Squad formatting patterns: Scannable structure with short paragraphs, bullet lists, "Try this" prompts at the top, experimental warnings, and cross-references at the bottom. - Test sync rule: Reminds contributors to update EXPECTED_* arrays in test/docs-build.test.ts whenever pages are added to features/, scenarios/, or guides/. - Use Case: When drafting a new feature page, apply the prescribed structure (H1 title, warning callout, try-this code block, overview, H2 sections) and update the doc build test assertions in the same commit. ## Quick Start Review my new documentation page against the Squad docs standards and fix any style or formatting violations.

Frequently Asked Questions about docs-standards

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

FAQPage Schema
How do I write documentation that follows the Microsoft Style Guide?

Use sentence-case headings, active voice, second person, and present tense throughout. Avoid ampersands in prose except in code, brand names, or UI elements, and keep paragraphs short for scannability.

What structure should a Squad documentation page follow?

Start with an H1 title, add an experimental warning callout if applicable, include a "Try this" code prompt, then an overview, a horizontal rule, and H2 content sections. Place cross-references to related pages at the bottom.

Why does the docs build test fail after adding a new page?

The test fails because new pages in features/, scenarios/, or guides/ must be added to the corresponding EXPECTED_* arrays in test/docs-build.test.ts. Update the assertions in the same commit as the new page.

Should headings use title case or sentence case in technical docs?

Use sentence case, such as "Getting started" rather than "Getting Started". Title-casing headings is listed as an anti-pattern under the Microsoft Style Guide rules.

When is it acceptable to use ampersands in documentation?

Ampersands are acceptable only inside code blocks, brand names, or UI element labels. In prose, always write "and" instead of "&".