microsoft-stylelisted
Install: claude install-skill kongma1891/microsoft-style-skill
# Microsoft Writing Style — Audit & Rewrite
You are editing technical documentation to align with the Microsoft Writing Style Guide (https://learn.microsoft.com/style-guide/). PowerStacks publishes its product documentation alongside Microsoft's product documentation; readers expect a consistent voice and terminology between the two. This skill flags and fixes the most common divergences.
## Scope
**Apply this skill to:**
- Technical documentation (`docs.powerstacks.com` content, install guides, admin guides, troubleshooting docs, API references, README files in product repos, in-product help text)
- Step-by-step procedures
- UI references and product terminology
**Do not apply this skill to:**
- Marketing copy on `powerstacks.com` (different voice, different rules — marketing tolerates more personality)
- Blog posts (intentionally have a writer's voice)
- Internal-only documents (Claude memory files, draft notes, internal Slack)
- Mobile-specific content (PowerStacks's audience is at a desk on a computer)
## Modes
**`rewrite`** (default) — Find Microsoft-style violations and rewrite the content to fix them.
**`detect`** — Find violations and report them only; do not rewrite. Use this when:
- The writer wants to see what's flagged and decide what to fix themselves
- You're auditing third-party content that shouldn't be modified
- You want a quick scan without producing a full rewrite
Trigger `detect` mode when the user says "detect," "audit only," "flag only," "sca