gum-monthly-release

Drafts monthly Gum release notes from merged PRs and commits since the previous release tag.

614|78|Updated Mar 11, 2015
One-click install
npx skills add https://github.com/vchelaru/Gum --skill gum-monthly-release
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gum-monthly-release
Source: https://github.com/vchelaru/Gum/tree/main/.claude/skills/gum-monthly-release
Command: npx skills add https://github.com/vchelaru/Gum --skill gum-monthly-release

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Writing monthly release notes for the Gum UI layout tool requires manually reviewing hundreds of merged PRs and commits, categorizing them between the Gum Tool and Gum Runtimes, and translating terse commit messages into user-facing language — a slow, error-prone process that often drops or compresses real changes.

Core Features & Use Cases

  • Canonical PR discovery: Derives the authoritative PR set from git log between release tags rather than date-based searches, avoiding undercounting when tags are published after their commits.
  • Parallel per-PR expansion: Fans out batches of PRs to subagents that read each PR's commits and diffs and return user-impact bullets, preventing a single agent from summarizing away detail.
  • Hybrid release format: Produces curated highlights (Breaking Changes, Biggest Changes, Gum Tool, Gum Runtimes, Tutorials and Templates) plus a complete per-PR What's Changed list and a Full Changelog placeholder, with image placeholders and an Open Questions block for review.
  • Use Case: Near month end, a maintainer runs the skill, answers three setup questions (release tag, previous-release boundary, migration doc URL), and receives a draft markdown file in /temp/ ready for collaborative review.

Quick Start

Ask the AI to draft this month's Gum release notes using the gum-monthly-release skill, then answer its questions about the release tag and previous-release boundary.

Frequently Asked Questions about gum-monthly-release

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

FAQPage Schema
How do I generate release notes from merged PRs on GitHub?

Derive the canonical PR set with git log between the previous release tag and main, parsing squash-merge subjects for PR numbers. Then fetch each PR's commits and files with the GitHub CLI and expand them into user-facing bullets grouped by section.

What tool drafts monthly release notes for the Gum UI framework?

The gum-monthly-release skill drafts Gum's monthly release notes by diffing against the previous release tag, expanding every PR's commits via parallel subagents, and outputting a hybrid markdown draft with curated highlights and a complete What's Changed list.

Why do date-based GitHub searches miss PRs for release notes?

A release tag is often published days after the commit it points to, so a merged:>=date filter drops PRs merged between the tagged commit and the publish date. Using git log against the tag itself captures the full set.

Can this skill be used for hotfix releases?

No, the skill is built for monthly-scale PR volume and explicitly excludes hotfixes. Emergency single-bug releases get a short manual note instead, as described in the repository's building-and-releasing documentation.

How are breaking changes handled in the release notes draft?

Breaking changes get their own section with one short sentence per change naming what was removed and its replacement, plus a link to the migration guide. The section is omitted entirely if there are no breaking changes that month.