Skip to content
Skills Library
Programming · Writing

github-release-notes-writer

/github-release-notes-writer

Draft or update user-focused GitHub Release Notes from verified tags, commits, pull requests, existing releases, and supplied changelog baselines. Use when preparing prerelease or stable release notes, turning GitHub's generated What's Changed list into a curated narrative, documenting upgrades or breaking changes, or producing a major-version migration summary. Do not use merely to validate a repository changelog fragment.

Repository
skills ↗
Licence
MIT
Last repository change
25.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
3
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 25.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Draft or update user-focused GitHub Release Notes from verified tags, commits, pull requests, existing releases, and supplied changelog baselines. Use when preparing prerelease or stable release notes, turning GitHub's generated What's Changed list into a curated narrative, documenting upgrades or breaking changes, or producing a major-version migration summary. Do not use merely to validate a repository changelog fragment.

Triggers from the description

s generated What
Original author description

Draft or update user-focused GitHub Release Notes from verified tags, commits, pull requests, existing releases, and supplied changelog baselines. Use when preparing prerelease or stable release notes, turning GitHub's generated What's Changed list into a curated narrative, documenting upgrades or breaking changes, or producing a major-version migration summary. Do not use merely to validate a repository changelog fragment.

How it works

  1. Operating Boundaries
  2. Workflow
  3. Handoff
Original SKILL.md headings · 142 lines, 957 words
SKILL.md preview
---
name: github-release-notes-writer
description: Draft or update user-focused GitHub Release Notes from verified tags, commits, pull requests, existing releases, and supplied changelog baselines. Use when preparing prerelease or stable release notes, turning GitHub's generated What's Changed list into a curated narrative, documenting upgrades or breaking changes, or producing a major-version migration summary. Do not use merely to validate a repository changelog fragment.
metadata:
  name: GitHub Release Notes Writer
  description: Write accurate, user-focused GitHub Release Notes with practical upgrade and migration guidance.
  author: Flc
  created: "2026-07-27T01:03:37Z"
---

# GitHub Release Notes Writer

Write Release Notes that help users understand why a release matters and how to upgrade safely without losing the exact changelog record.

## Operating Boundaries

- Default to a local Markdown draft. Do not create, edit, publish, or delete a GitHub Release unless the user explicitly asks for that write.
- Inspect release URLs, tags, pull requests, and repository content read-only when the user asks to research or draft.
- Treat Release Notes as user- and upgrader-facing. Do not copy a reviewer-focused Release PR description unchanged.
- Preserve the exact changelog baseline while curating its narrative and categories.
- Prefer current code, tests, documentation, tags, and GitHub state over recalled conversation details.

## Workflow

### 1. Discover release conventions and inputs

Read applicable repository instructions, release documentation, recent Release Notes, version manifests, and any user-provided baseline.

Identify:

- repository and target version
- prerelease or stable status
- immediate previous tag
- target tag or immutable target commit
- release branch when the target tag does not yet exist
- last stable version of the previous major when preparing a stable major release
- monorepo or multi-module upgrade requirements
- requested output path and whether publication is authorized

Follow the repository's established tone and heading style unless the user asks for another format.

### 2. Resolve the exact changelog range

Use the immediate previous tag to target tag or commit for `What's Changed` and the Full Changelog link:

```bash
git fetch --tags
git rev-parse <previous-tag>^{commit}
git rev-parse <target-tag-or-commit>^{commit}
git log --format='%H%x09%s' <previous-tag>..<target>
```

When the target is a stable major release following prereleases, use two layers:

| Layer | Purpose |
| --- | --- |
| Immediate previous tag to target | Exact PR inventory and Full Changelog |
| Previous stable major to target | Concise cumulative upgrade and migration context, not automatically an exact Git range |

Do not replace the exact delta inventory with the cumulative major-version story. Link earlier prerelease notes when they already contain detailed history.

Before describing the previous stable major as a Git comparison range, verify ancestry:

```bash
git merge-base --is-ancestor <previous-stable-tag> <target>
```

If it is not an ancestor, treat the stable-to-major relationship as a conceptual migration scope assembled from published releases, migration documentation, branch history, and final APIs. Do not assign it an exact commit or PR inventory and do not present a three-dot comparison link as authoritative.

If the target tag does not exist, label the range as provisional and do not claim a final Full Changelog URL is verified.

### 3. Build and reconcile the exact inventory

Treat the resolved commit range as the primary membership boundary. Extract PR references from commits and resolve ambiguous commits through GitHub commit-to-PR associations.

If the user provides a generated `What's Changed` baseline:

- preserve it as an inclusion source
- compare its PR-number set with the Git range
- resolve duplicates, missing PRs, direct commits, reverts, and release-preparation PRs
- explain every deliberate addition or removal

Include the release-preparation PR when its merged commit is inside the final range or the verified baseline includes it. Keep it in the inventory without presenting metadata alignment as a product highlight.

Maintain an internal deduplicated list containing PR number, title, author, category, and user impact.

### 4. Research user impact

Inspect the important PRs, final code, tests, examples, and documentation. Determine:

- new user-visible capabilities
- important fixes and changed behavior
- breaking APIs, defaults, configuration, data, or operational assumptions
- required and optional upgrade actions
- supported runtime or dependency changes
- multi-module version alignment requirements

Do not infer breaking behavior from titles alone. Verify final signatures and semantics. Include short before-and-after examples only when they materially improve migration safety.

### 5. Draft the Release Notes

Read [references/release-notes-conventions.md](references/release-notes-conventions.md) completely before drafting.

Use an adaptive structure. Lead with the release outcome and upgrade command, then explain highlights and migrations before the complete categorized inventory.

For multi-module ecosystems, tell users to upgrade every directly used module to a compatible release version when the repository evidence requires alignment.

### 6. Validate the draft

Before handoff or publication:

- verify version names, tag SHAs, comparison range, PR count, and deduplicated PR-number set
- compare the final inventory against the supplied baseline, if any
- ensure every highlight and migration claim is supported by final repository evidence
- ensure breaking changes identify affected users and required actions
- verify code examples against the released API
- verify the Full Changelog link uses the immediate previous tag and target tag
- remove absolute local paths, credentials, private hosts, temporary filenames, and machine-specific output
- keep ordinary Markdown paragraphs naturally wrapped; never enforce a source-code line-width limit

### 7. Write locally by default

Use the user's requested destination. Otherwise create a clearly named temporary Markdown draft outside the repository unless repository instructions specify a release-draft location.

Report the path and leave GitHub unchanged.

### 8. Publish only with explicit authorization

When the user explicitly asks to create or update the GitHub Release, use the reviewed local draft:

```bash
gh release edit <tag> --notes-file <draft-file>
gh release view <tag> --json tagName,name,isDraft,isPrerelease,body
```

Use `gh release create` only when the user explicitly asks to create a new Release and the target tag, title, draft/prerelease state, and target commit are verified.

After any write, read the Release back and verify its body and state. Do not alter assets, tags, titles, draft state, prerelease state, or latest-release status unless requested.

## Handoff

Report:

- target release and exact changelog range
- cumulative migration range or conceptual scope when used
- exact included PR count
- supplied-baseline reconciliation result
- local draft path
- whether GitHub was changed
- provisional links, missing evidence, or intentionally omitted content
Files in this package (3)
  • SKILL.md 7 KB
  • agents/openai.yaml 1 KB
  • references/release-notes-conventions.md 6 KB

Versions

The database has no other skills named github-release-notes-writer.

Database snapshot: 13.11.2026 · package version e50fb637a189 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100github-release-pr-writer
    Draft or update GitHub release pull request descriptions from verified tags, commits, merged pull requests, and the release diff. Use when a PR prepares a version, aligns release metadata, promotes a prerelease, or needs a reviewer-focused release summary, exact change…
  • 90release-notes
    Use when the user asks to draft release notes, changelog entries, or GitHub Release text from commits, tags, branches, or merged pull requests. Resolves an exact Git range and surfaces breaking changes, migrations, security impact, and upgrade steps.
  • 100release-notes-writer
    Automatically generate user-facing release notes from git commits, pull requests, changelogs, and code changes. Use when preparing software releases, creating version announcements, documenting what changed between versions, or communicating updates to users. Analyzes commit…
  • 100release-notes
    Generate release notes or changelog entries for completed changes. Use when asked to \"write release notes\", \"update the changelog\", \"document what changed\", \"create a release summary\", or when preparing a release. Follows Keep a Changelog format.
  • 90release-notes
    Write release notes or a CHANGELOG entry from the commits and merged PRs since the last release. Use when asked for "release notes", "update the changelog", "what changed since v1.2", or before tagging a release.
  • 100minutes-release-notes
    Draft user-facing Minutes release notes for a version from the commit range, recent GitHub releases, and the repository release checks. Use when the user asks to write, generate, prepare, revise, or review release notes or a changelog for a Minutes version.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.