list-consistency
$
npx mdskill add MicrosoftDocs/cloud-adoption-framework/list-consistencyEnforce parallel grammar and uniform punctuation across technical documentation lists.
- Corrects mixed grammatical forms and inconsistent end punctuation within bulleted or numbered lists.
- Requires no external tools; operates purely on textual structure analysis.
- Applies Microsoft Writing Style Guide rules to standardize list item syntax.
- Outputs the corrected, consistently formatted list directly to the user.
SKILL.md
.github/skills/list-consistencyView on GitHub ↗
--- 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.