generate-release-notes

name	generate-release-notes
description	Draft short project release notes from git tag diffs. Use when asked to summarize changes between releases/tags, especially when release notes should reference pull request numbers.

Release Notes

Use this skill to draft concise release notes for renCal from git history.

Workflow

1. Identify the current and previous release tags.

   • If the user names a tag, use that as the current tag.
   • Otherwise use git describe --tags --abbrev=0 for the current tag.
   • Find the previous tag with git tag --sort=-creatordate or semver ordering when relevant.

2. Inspect the changes between tags:

   git log --oneline --decorate <previous-tag>..<current-tag>
   git diff --stat <previous-tag>..<current-tag>
   

3. Inspect commit subjects/bodies for PR references:

   git log --format='%h%x09%s%x09%b' <previous-tag>..<current-tag>
   

   • Preserve PR references like (#30) from merge/squash commit subjects.
   • If a change comes from a non-PR commit, reference the short commit hash only when useful.
   • Prefer grouping related implementation details under the same PR number instead of listing every touched file.

4. If the diffstat is broad or unclear, inspect focused diffs for changed areas:

   git diff <previous-tag>..<current-tag> -- <path>
   

Output style

• Return short bullet-form notes grouped under these headings, omitting any empty section:
  • ### ✨ New features
  • ### 🛠️ Improvements
  • ### 🐛 Bug fixes
• Mention the compared range before the grouped notes when helpful, e.g. v0.1.0 since v0.0.6.
• Each bullet should describe user-visible impact first, then cite the PR/commit at the end.
• Use HTML <kbd> tags for keyboard shortcuts, e.g. <kbd>Ctrl</kbd><kbd>K</kbd> or <kbd>.</kbd>.
• Avoid internal implementation details unless they explain a visible improvement.
• Keep wording release-note friendly: concise, polished, and understandable to users.

Example

### ✨ New features

- Added a <kbd>Ctrl</kbd><kbd>K</kbd> command palette for quickly switching themes, switching calendar groups, and performing other actions. (#47)
- Added “Go to date…” so you can jump directly to a specific date from the command palette or with <kbd>.</kbd>. (#50)

### 🛠️ Improvements

- Reminders now support weeks and months, not just shorter intervals. (#52)
- All-day event editing: disabled time fields look cleaner, and unchecking all-day restores the previously selected time. (#53)

### 🐛 Bug fixes

- Fixed a startup crash affecting some Nvidia driver setups. (#46)
- Fixed Linux single-instance handling so repeated launches focus the existing app instead of leaking extra WebKit processes. (#51)
- Fixed stale “today” state so the calendar updates correctly after the day changes. (098e366)