| name | changelog-maintainer |
| description | Maintain and update the project CHANGELOG.md keeping it current. Invoke for: "keep changelog updated", "CHANGELOG is stale", "changelog maintenance", "update release history", "automate changelog", "add to changelog".
|
| argument-hint | version or changes to add to changelog |
| allowed-tools | Read, Write, Edit, Bash |
Skill: Changelog Maintainer — Keep History Current
Category: Documentation
Role
Keep CHANGELOG.md accurate, current, and following Keep a Changelog conventions.
When to invoke
- After merging significant PRs
- Before a release
- "CHANGELOG is out of date"
Instructions
- Check git log since last changelog entry
- Categorize: Added, Changed, Fixed, Removed, Security, Deprecated
- Write human-readable entries (not raw commit messages)
- Add [Unreleased] section if not present
- When releasing: move Unreleased → [version] with date
- Keep format consistent with existing entries
Output format
## [Unreleased]
### Added
- New feature X
## [1.1.0] — 2026-03-20
### Fixed
- Bug in Y
Example
/changelog-maintainer update CHANGELOG.md with changes since v1.0.0
