docs-standards

Enforce Microsoft Style Guide rules and squad-specific formatting in documentation.

Updated Jan 5, 2026
One-click install
npx skills add https://github.com/Golnaz89/golnaz89.github.io --skill docs-standards-golnaz89
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: docs-standards
Source: https://github.com/Golnaz89/golnaz89.github.io/tree/main/.copilot/skills/docs-standards
Command: npx skills add https://github.com/Golnaz89/golnaz89.github.io --skill docs-standards-golnaz89

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Squad documentation often lacks consistency and scannability, making it hard to discover and trust information across projects.

Core Features & Use Cases

  • Enforces Microsoft Style Guide rules (sentence-case headings, active voice, second person, present tense, no ampersands in prose).
  • Applies squad-specific formatting patterns (scannability-first layout, "Try this" prompts, experimental warnings, and cross-references at the bottom).
  • Provides a recommended structure and example templates to speed up authoring and reviews.

Quick Start

Draft your first doc page using the described structure and style rules.

Frequently Asked Questions about docs-standards

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

FAQPage Schema
How do I enforce documentation consistency across squad projects?

To enforce documentation consistency, apply Microsoft Style Guide rules for sentence-case headings, active voice, and present tense, while adopting squad-specific formatting patterns to ensure scannability and uniform tone across project pages.

What style guide rules should I use for technical documentation formatting?

Technical documentation formatting should enforce Microsoft Style Guide rules, including sentence-case heading capitalization, second-person voice, present tense, and avoiding ampersands in prose to maximize scannability and reader trust.

How do I structure documentation pages for better scannability?

Structure documentation pages using scannability-first layouts with cross-references at the bottom, experimental warnings, and "Try this" prompts to guide readers through the content efficiently.

Can I apply squad-specific conventions to standard documentation guidelines?

Yes, you can apply squad-specific conventions alongside standard documentation guidelines by integrating custom structural patterns and templates with Microsoft Style Guide rules to match your team's project requirements.

What is the best way to standardize tone and voice across reference pages?

To standardize tone and voice across reference pages, enforce active voice, second-person perspective, and present tense consistently, rejecting passive constructions and non-standard typography like ampersands in prose.