← ClaudeAtlas

maintainer-release-noteslisted

Prepares a release: reads git log since the last tag and the merged pull requests, writes a Keep a Changelog entry and human-friendly release notes, credits every contributor, flags breaking changes and suggests the semver bump. Works with conventional and plain commit messages. Never tags, pushes or publishes without confirmation. Use when the user says "write the release notes", "update the changelog", "what changed since the last release", "prepare v2.0", "what version should this be", "draft the GitHub release", or "cut a release".
vivekbhange-hub/maintainer-skill · ★ 0 · AI & Automation · score 75
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