# Semantic version release (/git--release)

/git--release is a Claude Code skill in the Code section. Works out the next semantic version from your commits, updates CHANGELOG.md, creates the git tag and, if asked, a GitHub release.

- Web version: https://skills.sgomez.dev/en/s/git--release
- Section: [Code](https://skills.sgomez.dev/en/code.md)
- Author: Santiago Gómez de la Torre
- License: MIT
- Source: https://github.com/sgomez-dev/claude-skills/blob/main/skills/git/release.md
- Updated 26 Mar 2026

## How to ask for it

- `/git--release cut the next version with its changelog`
- `/git--release publish a GitHub release with the matching tag`
- `/git--release generate version 2.1.0 with release notes`

## Install

macOS · Linux:

```
curl -fsSL https://raw.githubusercontent.com/sgomez-dev/claude-skills/main/install.sh | bash
```

Windows:

```
irm https://raw.githubusercontent.com/sgomez-dev/claude-skills/main/install.ps1 | iex
```

Claude Code plugin:

```
/plugin marketplace add sgomez-dev/claude-skills
/plugin install git-skills@claude-skills-collection
```

## Permissions

- Reads: `.git/**`, `CHANGELOG.md`
- Writes: `CHANGELOG.md`
- Runs: `git tag`, `git describe`, `git log`, `gh release create`
- Network: Yes
- Destructive: No

## Author's description

Create a semantic version release with tag, changelog, and GitHub release

- [How we review this](https://skills.sgomez.dev/en/methodology.md)