create-release-noteslisted
Install: claude install-skill atman-33/workhub
# Create Release Notes
Release notes are for **users of the software**, not its developers — that
distinction drives every step. A developer changelog (exhaustive, technical,
commit-shaped) is `prepare-release`'s job in the engineering plugin; this
skill produces the announcement.
## Steps
1. **Determine the range.** Default: latest tag → `HEAD`
(`git describe --tags --abbrev=0`). The user's explicit range or tag pair
overrides. If no tag exists, ask what "since the last release" means here.
2. **Collect the changes.** `git log <from>..<to> --pretty='%h %s%n%b'`.
Where commits are thin, enrich from merged PR titles/bodies
(`gh pr list --state merged --search <sha>` — best-effort; skip silently
if `gh` is unavailable).
3. **Filter for user visibility.** Keep what a user can see or feel:
features, fixes to behavior, performance, breaking changes, deprecations.
Drop refactors, CI, tests, docs-tooling, dependency bumps — unless one has
a user-visible consequence (e.g. a dependency bump that fixes a
vulnerability), in which case describe the consequence, not the bump.
- Completion criterion: every commit in the range is either represented in
a note or consciously dropped as internal — not silently lost.
4. **Write the notes.** In the language the release audience reads
(ask if unclear). Rules:
- Lead with the highlights: 1–3 sentences on what this release is about.
- Sections in impact order: **Breaking changes** (with migration st