Universal Release Workflow (release-skills)
Auto-detects your project's version file and changelogs, then bumps, documents, tags and publishes a release end to end.
Dev & CodingIntermediate★ 26,121⑂ 2,886AI score 9/10Last updated: Sep 10, 2026
What it does
- Detects version files across stacks:
package.json,pyproject.toml,Cargo.toml,marketplace.json,VERSION/version.txt. - Analyzes commits since the last tag using conventional commit types, flags BREAKING CHANGE, and recommends major/minor/patch.
- Finds every changelog (
CHANGELOG*.md,HISTORY*.md,CHANGES*.md), infers its language from the filename suffix, and writes native-language entries with built-in section title translations. - Credits outside contributors with
(by @username)by cross-checking merged PR authors against the repo owner. - Groups changes per skill/module, creates separate conventional commits, a release commit, an annotated tag from a notes file, and a GitHub Release via
gh. - Supports
--dry-runpreviews,.releaserc.ymloverrides, prepare/publish artifact hooks, and--backfill-releasesfor historical tags.
Who it's for
- Open-source maintainers keeping multi-language changelogs in sync.
- Developers releasing mixed repos (Node.js, Python, Rust, Claude plugins, generic).
- Teams that keep forgetting tags, release notes, or GitHub Releases when releasing by hand.
Examples
/release-skills --dry-run— see the proposed version, grouped commits, and per-language changelog preview before anything is written.- Say "ship a new version" — feat commits are found, version goes 1.2.3 → 1.3.0, annotated tag
v1.3.0is created and a GitHub Release is published. /release-skills --backfill-releases— create missing GitHub Releases for old tags using matching CHANGELOG sections, skipping lightweight-tag rewrites without confirmation.
· · · Install guide · · ·
Try it now, no install
Paste this into Claude to use the skill without installing anything.
Read the instructions in this file and follow them to help me: https://raw.githubusercontent.com/JimLiu/baoyu-skills/HEAD/.claude/skills/release-skills/SKILL.md What I want: (describe your task here)
If Claude can't open the link, open it yourself and paste the contents instead.
↓ If it works for you, download the ZIP below and install it. Then it runs on its own — no pasting each time.
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the .claude/skills/release-skills folder from the GitHub repo JimLiu/baoyu-skills into my ~/.claude/skills/release-skills/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/JimLiu/baoyu-skills.git && mkdir -p ~/.claude/skills && cp -r baoyu-skills/.claude/skills/release-skills ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Open a terminal and clone the repo:
git clone https://github.com/JimLiu/baoyu-skills.git - Create the skills directory:
mkdir -p ~/.claude/skills - Copy the skill in:
cp -r baoyu-skills/.claude/skills/release-skills ~/.claude/skills/ - For GitHub Releases, install the GitHub CLI and authenticate:
gh auth login - Restart Claude Code, go to your project, and run
/release-skills --dry-runto preview. - If the preview looks right, run
/release-skills(optionally--minor/--major) to perform the real release.
View source on GitHub ↗License: MIT