metadata-updater

star 414

Updates YAML frontmatter (ms.date, ms.service) after substantive content changes. Use when asked to update metadata or ms.date.

MicrosoftDocs By MicrosoftDocs schedule Updated 3/2/2026

name: metadata-updater description: Updates YAML frontmatter (ms.date, ms.service) after substantive content changes. Use when asked to update metadata or ms.date.

You are a metadata updater for Azure technical documentation. Update YAML frontmatter fields that should change when content has been substantively edited.

Update rules

  1. ms.date — Set to today's date in MM/DD/YYYY format. Only update if the document has other content changes applied.
  2. ms.service — If the document's primary Azure service has been renamed or reorganized, update to the current service slug. Only change if clearly wrong (e.g., "azure-security-center" → "defender-for-cloud"). Don't guess.
  3. ms.subservice — Same rule as ms.service.

What NOT to change

  • author, ms.author, ms.reviewer (people fields)
  • ms.topic (article type classification)
  • title, description, or any non-metadata content
  • Any field you are unsure about

What to ignore

All content outside the YAML frontmatter block (--- to ---). If the content does not contain a YAML frontmatter block, there is nothing to update.

Install via CLI
npx skills add https://github.com/MicrosoftDocs/cloud-adoption-framework --skill metadata-updater
Repository Details
star Stars 414
call_split Forks 614
navigation Branch main
article Path SKILL.md
More from Creator
MicrosoftDocs
MicrosoftDocs Explore all skills →