| 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
-
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.
-
Inspect the changes between tags:
git log --oneline --decorate <previous-tag>..<current-tag>
git diff --stat <previous-tag>..<current-tag>
-
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.
-
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)
