Formatting Changelogs

Normalizes CHANGELOG.md to Keep a Changelog form — one section per version, entries grouped under Added, Changed, and Fixed, newest first. Use when a changelog drifts from the format or before a release.

brokenrobot-xyz 307fd30 768 B Updated

File contents

Format a changelog

Rewrite CHANGELOG.md into Keep a Changelog form without dropping an entry.

Steps

  1. Read the changelog and parse each version section and its entries.
  2. Regroup the entries under Added, Changed, and Fixed. Keep an entry that fits none of the three under its original heading and report it, because a forced regroup rewrites the author's meaning.
  3. Order the sections newest first and rewrite the file.
  4. Report the sections you reordered and every entry you left ungrouped.

brokenrobot-xyz/agent-skills/tree/main/plugins/agent-authoring-toolkit/skills/reviewing-claude-skills/evals/files/eval-one-skill-scope/formatting-changelogs commit 307fd30362

Frequently asked questions

npx skillmds@latest add brokenrobot-xyz/formatting-changelogs