# 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.

- Skill: `brokenrobot-xyz/formatting-changelogs` (Agent Skill)
- Install (CLI): `npx skillmds@latest add brokenrobot-xyz/formatting-changelogs`
- Raw SKILL.md: https://api.skillmd.com/api/skills/brokenrobot-xyz/formatting-changelogs/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: brokenrobot-xyz (https://skillmd.com/u/brokenrobot-xyz)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/brokenrobot-xyz/formatting-changelogs

---


# 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.