# Changelog Writer

> Turn a set of merged changes into a clear, user-facing changelog entry.

- Skill: `tinyhumansai/changelog-writer` (Agent Skill)
- Install (CLI): `npx skillmds@latest add tinyhumansai/changelog-writer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tinyhumansai/changelog-writer/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tinyhumansai (https://skillmd.com/u/tinyhumansai)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/tinyhumansai/changelog-writer

---


# Changelog Writer

Convert a release's raw changes into a changelog that tells users what improved
and why they should care.

## When to use

- A release is about to ship and needs release notes.
- You are catching up an out-of-date changelog before an announcement.

## Steps

1. **Gather** the merged changes since the last release.
2. **Group** them into Added, Improved, Fixed — drop internal-only churn.
3. **Rewrite** each line in user terms: the benefit, not the commit message.
4. **Highlight** the one or two changes users will care about most.
5. **Add** the version, date, and any upgrade or breaking-change note.

## Output

A dated changelog entry grouped by Added / Improved / Fixed, written for users,
with breaking changes called out clearly.