skills.rest
umbraco
umbracoOFFICIAL
Explore all skills by this author →
WebsiteGitHub

umb-release-notes

Improves auto-generated GitHub release notes for Umbraco CMS by reconciling labelled PRs and recategorizing entries.

5.2k|2.9k|Updated Jun 10, 2013
Search Tags:#release notes#categorization#gh CLI#gitHub#Umbraco#Pull Requests#ChangeLog
One-click install
npx skills add https://github.com/umbraco/Umbraco-CMS --skill umb-release-notes
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: umb-release-notes
Source: https://github.com/umbraco/Umbraco-CMS/tree/main/.claude/skills/umb-release-notes
Command: npx skills add https://github.com/umbraco/Umbraco-CMS --skill umb-release-notes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Auto-generated GitHub release notes are often incomplete, miscategorized, and cluttered with internal-only entries, forcing maintainers to manually cross-check every labelled PR before publishing an Umbraco CMS release.

Core Features & Use Cases

  • Completeness check: Queries every merged PR carrying the release/<version> label via the GitHub CLI and adds any missing from the notes.
  • Recategorization: Re-files each PR under the correct heading (Features, Bug Fixes, Performance, Testing, etc.) using label and title signals, while leaving Notable and Breaking sections untouched.
  • Noise removal: Strips purely-internal entries such as CI fixes and branch maintenance that have no reader value.
  • Use Case: Before publishing Umbraco CMS 17.5.0, run the skill against the generated notes file to produce a complete, well-organized - with updates version ready for review.

Quick Start

Improve the release notes for version 17.5.0 using the generated notes file at C:\Temp\release-17.5.0-rc.md.

Frequently Asked Questions about umb-release-notes

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I improve auto-generated GitHub release notes?▼

Provide the release version and the path to the generated notes file. The skill fetches every merged PR with the release/<version> label via the GitHub CLI, adds missing entries, recategorizes them, and writes an updated file alongside the input.

How to cross-check release notes against labelled PRs on GitHub?▼

The skill runs gh pr list with the release/<version> label on umbraco/Umbraco-CMS to build the authoritative PR list, then compares it against PR numbers parsed from the notes file and adds any that are missing.

Does this skill require the GitHub CLI to be authenticated?▼

Yes, it runs gh auth status first and stops if authentication fails, since it needs the GitHub CLI to query PRs in the umbraco/Umbraco-CMS repository. Run gh auth login before invoking it.

Will it modify the original release notes file?▼

No, it writes a new file in the same folder with ' - with updates' appended before the extension, so you can diff the two versions. The header comment, New Contributors section, and Full Changelog line are preserved exactly.

What happens if a release has more than 1000 labelled PRs?▼

The skill guards against silent truncation by counting returned rows against the --limit value. If the count equals the limit, it raises the limit and re-fetches before continuing, so no PRs are dropped.

Related Skills

Explore More Software Engineering Skills→
josemartinrodriguezmortalonijosemartinrodriguezmortaloni

git-release

Draft release notes from merged pull requests and propose version bumps.

Community
Intermediate
TeoSlayerTeoSlayer
7

pilot-release-management-setup

Automate a three-agent release workflow for changelogs, versioning, and announcements.

Community
Advanced
sangrokjungsangrokjung
1

release-note-generation

Generate PowerToys release notes from merged GitHub Pull Requests.

Community
Advanced
marquesfelipmarquesfelip

automated-versioning

Automate semantic version bumps from conventional commits in CI/CD pipelines.

Community
Advanced