create-release

name	create-release
description	Create a GitHub release with tag and notes. Use when: create release, tag release, publish release, draft release, new version, cut release.
argument-hint	<vYY.M.P>
user-invocable	true
disable-model-invocation	false

Create GitHub Release

Preflight

Complete the shared repository skill preflight before continuing.

Steps

1. Determine the tag — convention: vYY.M.P (e.g., v26.5.1) 1.1. List recent tags to suggest next logical tag 1.2. Resolve repository and default branch 1.3. Verify the tag and release do not exist 1.4. Ask target commit/branch (default: repository default branch) 1.5. Ask draft or published (default: published) ^1
2. Determine release notes — offer three options: 2.1. Auto-generate from commits — find previous tag for --notes-start-tag 2.2. User provides markdown directly 2.3. Use create-release-notes skill first, then pass output here
3. Build the command — pick the matching template: 3.1. Auto-generated notes → create-release-auto 3.2. Auto-generated notes, draft → create-release-auto-draft 3.3. Explicit notes → create-release-explicit 3.4. Explicit notes, draft → create-release-explicit-draft
4. Present command — show to user, wait for explicit confirmation
5. Execute — run command, then show the release URL
6. Publish draft (optional) — publish-draft