gum-release

SkillDocs & knowledge

Gum release/build orchestration, drives the in-repo release checklist and hands off the notes draft. Triggers: cutting a release, publishing the Gum NuGet packages, releasing the tool, /gum-release.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the gum-release skill

What this skill tells your AI

The instructions your AI receives, as published by vchelaru/gum in .claude/skills/gum-release/SKILL.md and read by ahel’s review.

Invoking product-manager agent to drive the Gum release checklist.

Gum Release Orchestrator

This skill is a guided checklist driver, not full automation. Most release steps are inherently human — taking screenshots, clicking GitHub Actions, uploading to FTP, announcing on Discord/Twitter/Bluesky. The skill's job is to walk the maintainer through the steps in order, track what's done, and invoke the one step a skill can actually do (the notes draft).

Source of truth — do not restate it here

The release process lives in docs/contributing/building-and-releasing-gum.md (published to the Gum GitBook space). That doc is canonical and maintainer-edited. Read it at the start of every run and follow whatever it says today — do not hardcode or paraphrase its steps into this skill, or the two will drift.

How to run

  1. Read the doc above and confirm the current step list with the user.
  2. Ask if this is a hotfix — an emergency tool release for a bad bug, outside the normal cadence. If yes, follow the doc's "Hotfixes" subsection: skip gum-monthly-release (write a short manual note instead), skip screenshots and community announcements, and confirm with the user that the fix carries no breaking changes before tagging.
  3. Track progress — create one task per step (TaskCreate) so nothing is dropped across the long-running release, and mark each completed as the user confirms it. For a hotfix, only create tasks for the steps that apply.
  4. Walk the steps in order, one at a time. For each, state what the user needs to do (the doc has the detail) and wait for confirmation before advancing.
  5. Hand off the automatable step (non-hotfix only). Release-notes generation is the only step with real automation, and it lives in gum-monthly-release. That skill is disable-model-invocation: true, so the Skill tool refuses it — read .claude/skills/gum-monthly-release/SKILL.md and follow it yourself instead. Everything else (NuGet workflow trigger, Build-and-Release workflow, screenshots, migration doc, announcements, FRB FTP upload) is the user's manual action; you confirm and check it off.

Gotchas

  • The two processes in the doc — NuGet publishing and tool release — are independent. Ask which the user is doing; don't assume both.
  • A hotfix is a mode of the tool release, not a separate process — same steps, minus notes/promotion. Don't run gum-monthly-release for one.
  • gum-monthly-release only writes the notes markdown. It does not bump versions, cut the tag, or trigger workflows — those are separate manual steps in the doc.
  • The Full Changelog compare link in the notes can only be filled after the tag exists, so it stays a placeholder until the release is cut.

Signals

GitHub stars
620
Forks
80
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
gum-release
Source
github.com/vchelaru/gum