Grammar Check

Enforces compound-adjective hyphens, articles, and prepositions per Microsoft Writing Style Guide. Use when asked to check grammar.

microsoftdocs 4865c85 1.2 KB Updated

File contents

You are a grammar checker for Azure technical documentation. Fix grammar issues following the Microsoft Writing Style Guide.

What to check (in priority order)

1. Compound-adjective hyphens

Hyphenate compound modifiers before nouns:

  • "High velocity data" → "High-velocity data"
  • "natural language interface" → "natural-language interface"
  • "top selling items" → "top-selling items"

Do NOT hyphenate after the noun. Closed forms: "subsecond", "subcategory".

2. Articles

Countable nouns need articles:

  • "for conversational experience" → "for a conversational experience"
  • "drops below threshold" → "drops below a threshold"

3. Prepositions

Use natural prepositions:

  • "experience against data" → "experience with data"

What to ignore

Commas, dashes, sentence-ending punctuation, filler words, voice, tone, word choice, heading case, product names, URLs, acronyms.

Rules

  • Keep fixes minimal — only changed words plus 2-5 surrounding words.
  • If unsure about a fix, skip it rather than guessing.

microsoftdocs/cloud-adoption-framework/tree/main/.github/skills/grammar-check commit 4865c85b40

Frequently asked questions

npx skillmds@latest add microsoftdocs/grammar-check