skills.rest
suxrobGM
suxrobGMCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

release

Bump unified version numbers, update the changelog, commit, and tag a new release.

73|19|Updated Mar 22, 2026
Search Tags:#changelog#commit#release#semver#version bump#git tag#ci workflow
One-click install
npx skills add https://github.com/suxrobGM/jobpilot --skill release-suxrobgm
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: release
Source: https://github.com/suxrobGM/jobpilot/tree/main/.claude/skills/release
Command: npx skills add https://github.com/suxrobGM/jobpilot --skill release-suxrobgm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Cutting a release requires manually keeping multiple version fields in sync, writing changelog entries, and creating consistent git tags, which is error-prone and easy to get wrong. ## Core Features & Use Cases - Unified Version Bumping: Updates the version in lockstep across the .NET csproj file, both plugin.json manifests, and package.json, reconciling mismatches before bumping. - Automated Changelog Generation: Groups commits since the previous tag into Keep a Changelog sections (Added, Changed, Fixed) with user-facing summaries. - Safe Release Workflow: Runs pre-flight checks (clean working tree, correct branch, no duplicate tag), then commits and creates an annotated git tag that triggers the CI release workflow. - Use Case: You finished a sprint of changes on main and want to ship version 2.1.0. Invoke the skill with the version or a bump type, and it synchronizes all four version files, prepends a changelog section, commits, and tags v2.1.0 ready for you to push. ## Quick Start Ask the agent to cut a new release with a patch bump, or specify an explicit version like 2.1.0 to release.

Frequently Asked Questions about release

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

FAQPage Schema
How do I bump the version and tag a new release?▼

Provide a version number like 2.1.0 or a bump type (major, minor, patch). The skill updates all four version files, prepends a changelog section, commits with a release message, and creates an annotated vX.Y.Z tag.

How do I generate a changelog from git commits?▼

The skill lists commits since the previous tag with git log, groups them under Added, Changed, and Fixed headings, and prepends a dated section to CHANGELOG.md in Keep a Changelog format. Merge commits and release commits are skipped.

What happens if version numbers differ across project files?▼

The skill reads the version from the csproj file, both plugin.json manifests, and package.json. If they differ, it reports the mismatch and reconciles all files to the highest version before applying the bump.

Does the release skill push the tag to the remote repository?▼

No, the skill never pushes. After committing and tagging locally, it reminds you to run git push and git push origin vX.Y.Z yourself, which triggers the release workflow.

Why does the release fail before bumping the version?▼

Pre-flight checks stop the release if the working tree is dirty, the current branch is not main, or the target tag already exists. The skill reports the failure instead of bypassing hooks or checks.

Related Skills

Explore More Software Engineering Skills→
WesleyMFrederickWesleyMFrederick

git-merging-feature-branches-to-main-skill

Squash a reviewed feature branch into main with git merge --squash.

Community
Intermediate
joelreymontjoelreymont
43

Release Skill

Tag the current commit and push releases to GitHub for CI builds.

Community
Advanced
baekenoughbaekenough
13

omcustom:npm-publish

Validate package.json, run tests, and publish npm packages with a specified tag.

Community
Intermediate
reaatechreaatech
2

Changelog Generation

Generate CHANGELOG.md entries and version bumps from conventional commits using Changesets.

Community
Advanced