heading-case
Enforces sentence case for all Markdown headings and sub-headings.
Install
mkdir -p .claude/skills/heading-case && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/10418" && unzip -o skill.zip -d .claude/skills/heading-case && rm skill.zipInstalls to .claude/skills/heading-case
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Enforces sentence case for all Markdown headings and bold sub-headings. Use when asked to fix heading capitalization.Key capabilities
- →Enforce sentence case for headings
- →Enforce sentence case for bold sub-headings
- →Preserve proper nouns
- →Fix formatting errors in headings
How it works
It scans Markdown headings and bold labels, applying sentence case while respecting a defined list of proper nouns.
Inputs & outputs
When to use heading-case
- →Fixing documentation heading styles
- →Standardizing documentation formatting
About this skill
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.
When not to use it
- →Editing body text
- →Editing URLs
- →Editing code blocks
Limitations
- →Does not process body text
- →Requires manual proper noun maintenance
How it compares
This automates style guide compliance for headings, replacing manual proofreading.
Compared to similar skills
heading-case side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| heading-case (this skill) | 0 | 5mo | No flags | Beginner |
| ml-paper-writing | 48 | 6mo | Review | Advanced |
| docs-review | 10 | 7mo | No flags | Beginner |
| claude-md-improver | 21 | 6mo | Review | Beginner |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by MicrosoftDocs
View all by MicrosoftDocs →You might also like
ml-paper-writing
davila7
Write publication-ready ML/AI papers for NeurIPS, ICML, ICLR, ACL, AAAI, COLM. Use when drafting papers from research repos, structuring arguments, verifying citations, or preparing camera-ready submissions. Includes LaTeX templates, reviewer guidelines, and citation verification workflows.
docs-review
metabase
Review documentation changes for compliance with the Metabase writing style guide. Use when reviewing pull requests, files, or diffs containing documentation markdown files.
claude-md-improver
anthropics
Audit and improve CLAUDE.md files in repositories. Use when user asks to check, audit, update, improve, or fix CLAUDE.md files. Scans for all CLAUDE.md files, evaluates quality against templates, outputs quality report, then makes targeted updates. Also use when the user mentions "CLAUDE.md maintenance" or "project memory optimization".
write-docs
tldraw
Writing SDK documentation for tldraw. Use when creating new documentation articles, updating existing docs, or when documentation writing guidance is needed. Applies to docs in apps/docs/content/.
update-docs
vercel
This skill should be used when the user asks to "update documentation for my changes", "check docs for this PR", "what docs need updating", "sync docs with code", "scaffold docs for this feature", "document this feature", "review docs completeness", "add docs for this change", "what documentation is affected", "docs impact", or mentions "docs/", "docs/01-app", "docs/02-pages", "MDX", "documentation update", "API reference", ".mdx files". Provides guided workflow for updating Next.js documentation based on code changes.
wiki-architect
microsoft
Analyzes code repositories and generates hierarchical documentation structures with onboarding guides. Use when the user wants to create a wiki, generate documentation, map a codebase structure, or understand a project's architecture at a high level.