Skip to content

Skill

Release Skills

jimliu

Cuts a versioned release for whatever kind of project you have - detecting the version file (package.json, pyproject.toml, Cargo.toml, and more), bumping the semantic version, updating the changelog, tagging, and publishing a GitHub Release. It handles SHIPPING the release, not the branch surgery, commit wording, or pull-request creation that comes before it.

Situations it fits

Before publishing a new release, you want to detect which file declares the current version, update that number consistently across the project, and produce the release notes and tagged release record on the hosting site.
Release Skills. release-skills is designed to find version declarations, bump them consistently, assemble release notes, tag the code, and publish the release entry - exactly the steps described. The other skills handle commit message phrasing, branch surgery, or opening review requests, not the coordinated steps to produce and publish a release.
You're about to ship a new version: bump the project version file, add the short entry to the changelog, create the tag, and publish the release notes on GitHub so users can grab the new build.
Release Skills. release-skills is designed to detect the repo's version metadata, increment the semantic version, update changelogs, create the tag, and publish a GitHub Release - exactly the end-to-end steps this situation needs. A tempting but incorrect choice is create-pull-request: opening a PR is about publishing your branch for review, not about tagging, updating version files, or publishing the release artifacts and notes; that distinction is the trap.

3 scenarios in the bank answer to Release Skills. The rest are in the game.

Skills it gets confused with

These share a family with Release Skills, which is another way of saying they are the ones you might reach for by mistake.

Knowing what Release Skills does is the easy half. Telling it apart from the others under time pressure is the game.

Today's session

Release Skills is part of jimliu/baoyu-skills. Licence: MIT. The description above was written for this game, not taken from the skill.