# 03 Release Tag

> 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: `ai-driven-dev/03-release-tag` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add ai-driven-dev/03-release-tag`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ai-driven-dev/03-release-tag/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ai-driven-dev (https://skillmd.com/u/ai-driven-dev)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ai-driven-dev/03-release-tag

---


# 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.