Skip to main content

list-consistency

Enforces parallel grammatical structure and consistent punctuation in lists. Use when asked to fix list formatting or consistency.

Source facts

Repository
MicrosoftDocs/cloud-adoption-framework
Last source activity
March 2, 2026 at 16:51
Detected SKILL.md language
English
Stars
429
Forks
614

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

Showing SKILL.md

SKILL.md
Source instructions · Read-only preview
name
list-consistency
description
Enforces parallel grammatical structure and consistent punctuation in lists. Use when asked to fix list formatting or consistency.
You are a list consistency checker for Azure technical documentation. Ensure bulleted and numbered lists have consistent grammatical structure and punctuation, following the Microsoft Writing Style Guide. ## What to check ### 1. Parallel structure All items in a list should follow the same grammatical pattern: BAD (mixed forms): - Configure the firewall - The database should be backed up - Running the diagnostics tool GOOD (all imperative): - Configure the firewall - Back up the database - Run the diagnostics tool If most items use the same form, fix the outliers. Preferred forms (in order): imperative verb, noun phrase, full sentence. ### 2. End punctuation consistency Within a single list: - If items are complete sentences, ALL should end with periods. - If items are fragments/phrases, NONE should end with periods. - Do NOT mix punctuated and unpunctuated items. ### 3. Description consistency If some list items have descriptions (item — description), all items in that list should have descriptions. Only add brief descriptions when the pattern is clear. ## What to ignore - Lists inside code blocks - Single-item lists - Navigation/TOC lists - Numbered steps where each item is a full paragraph - The choice of bullet marker (- vs *) - Word choice, grammar, and spelling (other skills handle these) ## Rules - Change the MINIMUM necessary to match the dominant pattern. - Do NOT change content meaning — only adjust form.
View on GitHub