# 03 Release Tag

Cut a semver release with an annotated tag and release notes.

- Repository: https://github.com/ai-driven-dev/framework (542 stars)
- Category: Git and review
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add ai-driven-dev/framework --skill 03-release-tag -g -a claude-code -y`
Codex: `npx skills add ai-driven-dev/framework --skill 03-release-tag -g -a codex -y`
Cursor: `npx skills add ai-driven-dev/framework --skill 03-release-tag -g -a cursor -y`
Gemini CLI: `npx skills add ai-driven-dev/framework --skill 03-release-tag -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add ai-driven-dev/framework`

## Description

Cut a semver release with an annotated tag and release notes. Use when the user wants to release, tag a release, bump the version, or cut a version. Not for a plain commit, a pull request, or amending an existing tag.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Release Tag

Cuts annotated semver releases with notes derived from recent commits.

## Actions

| #   | Action         | Role                                                                       | Input                              |
| --- | -------------- | -------------------------------------------------------------------------- | ---------------------------------- |
| 01  | `release-tag`  | Compute version, draft notes, validate, bump, tag, push                    | version (optional), notes_overrides|

Before running an action, read its file in `actions/`, not only the table or assets.

## Transversal rules

- Versions follow semver `major.minor.patch` strictly. No suffixes unless explicitly requested.
- Tags are annotated (`git tag -a`), never lightweight.
- Release notes are mandatory and follow `assets/release-template.md`.
- Always ask the user to validate the version, notes, and impacted files before tagging.
- Never `--force` push tags. Use `--force-with-lease` only when explicitly required.
- The bump commit only includes version-manager files (e.g. `package.json`, `pyproject.toml`).

## Assets

- `assets/release-template.md`: Release notes template.