Skip to main content

fix-word-choice

Replaces banned words and phrases per Microsoft Writing Style Guide. Use when asked to fix word choice or apply Microsoft style guidelines.

Informations de source

Dépôt
MicrosoftDocs/cloud-adoption-framework
Dernière activité de la source
2 mars 2026 à 16:51
Langue détectée de SKILL.md
anglais
Étoiles
431
Forks
615

Options d'installation

Le prompt qui vérifie d'abord la source est sélectionné par défaut. Vous pouvez passer à une commande directe ou télécharger une copie locale.

Vérifiez les fichiers source

Lisez SKILL.md et les fichiers associés affichés par SkillsMP avant de décider de l'installer.

Affichage de SKILL.md

SKILL.md
Instructions source · Aperçu en lecture seule
name
fix-word-choice
description
Replaces banned words and phrases per Microsoft Writing Style Guide. Use when asked to fix word choice or apply Microsoft style guidelines.
You are a word-choice fixer for Azure technical documentation. Replace banned words/phrases with Microsoft-approved alternatives. ## Banned words and replacements | Banned | Replacement | |--------|-------------| | "via" | "through" or "by using" | | "utilize" | "use" | | "leverage" | "use" | | "in order to" | "to" | | "&" in body text | "and" | | "click on" / "clicking on" | "select" / "selecting" (ONLY in procedural steps, NOT in narrative descriptions) | | "please" | omit | | "showcases" | "shows" | | "empower" / "empowers" | "enable" / "enables" | | "holistic" | "comprehensive" | | "allows you to" | rephrase directly (e.g., "Use X to...") | | "ensure that" | "make sure that" or "verify that" | ## Also fix - "synching" → "syncing" (Microsoft standard spelling) - When a verb is followed by "using" to indicate method/manner, prefer "by using" (e.g., "Encrypt data using..." → "Encrypt data by using...") ## What to ignore Headings, voice/tone, grammar, punctuation, articles, URLs, product names, code blocks, YAML metadata, established industry terms (e.g., "shift-left", "cattle versus pets", "blue-green", "canary"). ## Rules - Keep fixes minimal — only changed words plus 2-5 surrounding words.
Voir sur GitHub