# release-manager

release-manager — a skill for Claude Code, Codex, Cursor, Copilot and Gemini CLI that turns git log output or a JSON plan into a changelog, a SemVer bump and a release readiness score. Run it before every release or hotfix.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 132 installs · ★ 1183 repo stars
- Author: borghei
- License: LicenseRef-MIT-Commons-Clause · policy=link-only · description only; the file stays with the author
- Source: https://github.com/borghei/Claude-Skills/tree/HEAD/engineering/release-manager/SKILL.md
- Updated: 2026-11-08
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/borghei-release-manager

## What it does

The skill runs on six platforms: Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode. Three Python scripts — `changelog_generator.py`, `version_bumper.py` and `release_planner.py` — work on piped text or a local file and do not need a live repo checkout.

\`changelog_generator.py` produces Keep-a-Changelog Markdown or JSON. `version_bumper.py` reads conventional-commit types to pick MAJOR, MINOR or PATCH; the sample log includes two `!` commits, which push 1.2.3 to 2.0.0. `release_planner.py` takes a JSON plan, computes a readiness score, and outputs a checklist, rollback runbook and stakeholder message templates via `--include-rollback --include-communication`. The sample plan comes back BLOCKED at 72.2% with three named blockers.

Two inputs cause wrong output. Passing `git log --oneline` hides `BREAKING CHANGE:` footers, so only `!` commits count and the bump lands at MINOR instead of MAJOR — use full `git log` format when the team writes footers. The generated rollback runbook uses generic steps and time estimates; replace them with the real commands for the target system before treating the runbook as executable.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill release-manager -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/release-manager/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/release-manager/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill release-manager -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/release-manager/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill release-manager -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/release-manager/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install borghei/Claude-Skills engineering/release-manager/SKILL.md
```

2. **Manually: put the files in place**
- File: `.github/skills/release-manager/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill release-manager -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/borghei/Claude-Skills --path engineering/release-manager
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/release-manager/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add borghei/Claude-Skills --skill release-manager -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/borghei/Claude-Skills/tree/HEAD/engineering/release-manager/SKILL.md

## When to use it
- generate a changelog from a commit range
- calculate the next SemVer version from conventional-commit types
- score release readiness and surface blockers from a plan JSON
- build a rollback runbook and stakeholder comms for a hotfix
- audit which commits are non-conventional and would be dropped

## Example prompts
- Run `changelog_generator.py` on `assets/sample_git_log.txt` and produce a changelog for version 2.0.0
- Pipe `git log` from v1.4.0 to HEAD into `version_bumper.py` with current version 1.4.0 and show the analysis
- Score `plan.json` with `release_planner.py`, include the checklist and rollback runbook, list all blockers

## Similar
- [release-skills](https://affpapa.org/en/nevibecode/skills/release-skills.md) — skill · 26100 installs
- [update-infos-release](https://affpapa.org/en/nevibecode/commands/update-infos-release.md) — command · ★ 6529 repo stars
- [release](https://affpapa.org/en/nevibecode/skills/toss-release.md) — skill · 208 installs
- [release-bumper](https://affpapa.org/en/nevibecode/skills/release-bumper.md) — skill · 105 installs
- [auto-release-manager](https://affpapa.org/en/nevibecode/skills/auto-release-manager.md) — skill · 3 installs
- [team-release](https://affpapa.org/en/nevibecode/skills/sametcelikbicak-team-release.md) — skill · ★ 71 repo stars

## Other versions with the same name
- [release-manager · daffy0208](https://affpapa.org/en/nevibecode/skills/release-manager.md) — 135 installs

From the same set: [borghei/claude-skills](https://affpapa.org/en/nevibecode/by/borghei/claude-skills.md) — 120 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
