maintainer-release-noteslisted
Install: claude install-skill vivekbhange-hub/maintainer-skill
# Release notes and changelog
Release notes are for users ("what changes for me?"); the changelog is the permanent record. Both
come from the same commits, so this skill builds them together, from the git history and PR
data, and lets the maintainer fix wording before anything is tagged.
## Steps
1. **Find the range.**
```
git fetch --tags --quiet
git describe --tags --abbrev=0
```
Use the argument if the user gave a tag. If there are no tags, use the root commit and treat
the release as the first one (`--current 0.0.0`, then ask whether it should be 0.1.0 or 1.0.0).
Confirm the branch: releases normally come from the default branch (`gh repo view --json defaultBranchRef`).
2. **Collect commits** in the record format the helper understands (keeps bodies, so
`BREAKING CHANGE:` footers are seen):
```
git log <tag>..HEAD --no-merges --pretty=format:'%h%x1f%an%x1f%s%x1f%b%x1e' > maintainer/.cache/log.txt
```
3. **Run the helper.**
```
python3 "${CLAUDE_SKILL_DIR}/changelog.py" maintainer/.cache/log.txt --current <tag> --date <YYYY-MM-DD> --repo-url https://github.com/<owner>/<repo>
python3 "${CLAUDE_SKILL_DIR}/changelog.py" maintainer/.cache/log.txt --current <tag> --format json
```
It groups commits into Added / Changed / Deprecated / Removed / Fixed / Security, hides
docs/chore/ci/test commits (add `--include-internal` to show them), skips merge and release
commits, lists contributors without bots, and suggests the bump