heading-case

$npx mdskill add MicrosoftDocs/cloud-adoption-framework/heading-case

Standardize Markdown headings and bold subheadings to strict sentence case when asked to correct capitalization.

  • Corrects inconsistent capitalization in document titles and section headers.
  • Operates purely on Markdown syntax within provided text content.
  • Applies specific rules for proper nouns, conjunctions, and spacing within headings.
  • Outputs the corrected text block, leaving body content and code untouched.

SKILL.md

.github/skills/heading-caseView on GitHub ↗
---
name: heading-case
description: Enforces sentence case for all Markdown headings and bold sub-headings. Use when asked to fix heading capitalization.
---

You are a heading-case fixer for Azure technical documentation.

## Rule

All Markdown headings (`##`, `###`, `####`) and bold sub-headings (`**Bold Label**`) MUST use sentence case. Sentence case = capitalize only the first word and proper nouns.

## Proper nouns (keep capitalized)

Azure, Microsoft, Power BI, KQL, Fabric, Copilot, Purview, Entra, Conditional Access, Real-Time Intelligence, Service Bus, Eventhouse, Eventstream, Activator, Teams.

Generic words are NOT proper nouns: "queryset", "dashboards", "bottlenecks", "integration", "encryption", "logging".

## Also fix in headings

- "&" → "and"
- Missing space after number: `**8.Title**` → `**8. Title**`

## What to ignore

Body text, URLs, code blocks, YAML metadata.

More from MicrosoftDocs/cloud-adoption-framework

SkillDescription
acronym-checkEnsures abbreviations are expanded on first use per Microsoft style. Use when asked to check acronyms or abbreviations in documentation.
active-voiceRewrites passive voice to active/imperative and enforces second person. Use when asked to fix passive voice or improve writing directness.
api-consistencyEnsures Azure REST API and CLI consistency across a document. Use when asked to check API calls, CLI parameters, or REST consistency.
azure-validationValidates portal navigation paths, detects contradictions against Microsoft Learn documentation, and checks alignment with current Azure implementation standards. Use when asked to verify Azure portal instructions or validate content accuracy.
check-accessibilityChecks image accessibility compliance per Microsoft Learn standards. Use when asked to review images for alt text, lightbox paths, or complex image markup.
check-relevanceAssesses whether guidance is still relevant and framed for modern Azure approaches. Use when asked to check if content is still current or strategically relevant.
cloud-adoptionHow to adopt and integrate the Microsoft Azure cloud into your organization. Strategy, policies, organizational readiness, architecture, platform landing zone, governance, security, health, and operations.
code-expertIdentifies definite errors in code samples including syntax errors, missing imports, and deprecated APIs. Use when asked to review code samples for correctness.
code-freshnessReviews code samples for modern patterns, deprecated APIs, outdated dependencies, and alignment with current Microsoft best practices. Use when asked to update or modernize code samples.
code-verifierVerifies code samples against official Microsoft/Azure examples and syntax rules. Use when asked to verify code correctness or validate API usage.