version-release

name	version-release
description	Tag a release, create a GitHub release with notes, and bump to the next patch version. Reports current state, tags, publishes, and bumps in one flow.

Version Release

Tag, release, and bump the version for gemini-live-tools in one command.

When to Use This Skill

• User says "release", "tag", "version release", or "cut a release"
• User wants to publish the current version

Version Location

Version	File	Purpose
version	python/pyproject.toml	Python package version

Project root: /Users/ibenian/dev/gemini-live-tools

Step 1: Report Current State

Before anything, read and report:

grep '^version' python/pyproject.toml
git tag --sort=-v:refname | head -5
gh release list --limit 5
git branch --show-current

Tell the user:

• Current version in pyproject.toml
• Latest git tag
• Latest GitHub release
• Current branch

Step 2: Confirm with User

Show what will happen:

• Tag vX.Y.Z on current commit
• Create GitHub release vX.Y.Z with notes
• Bump pyproject.toml to X.Y.(Z+1) via PR
• Merge the bump PR

Wait for user confirmation before proceeding.

Step 3: Tag and Release

Must be on main and up to date:

git checkout main && git pull

Tag the current commit:

git tag vX.Y.Z
git push origin vX.Y.Z

Then create a GitHub release. Generate release notes from all commits since the last tag:

git log v0.1.(Z-1)..vX.Y.Z --oneline

The release body should include:

• A ## What's Changed section listing all changes (group by PRs where possible)
• A commit span line at the bottom: **Full changelog**: v0.1.(Z-1)...vX.Y.Z

gh release create vX.Y.Z --title "vX.Y.Z" --notes "$(cat <<'NOTES'
## What's Changed
- item 1 (#PR)
- item 2 (#PR)
- ...

**Full changelog**: https://github.com/ibenian/gemini-live-tools/compare/v0.1.(Z-1)...vX.Y.Z
NOTES
)"

Step 4: Bump to Next Version

Create a PR to bump pyproject.toml to the next patch:

git checkout -b chore/bump-version-X.Y.(Z+1)
# Edit python/pyproject.toml: X.Y.Z → X.Y.(Z+1)
git add python/pyproject.toml
git commit -m "chore: bump version to X.Y.(Z+1)"
git push -u origin chore/bump-version-X.Y.(Z+1)
gh pr create --title "chore: bump version to X.Y.(Z+1)" --body "Post-release version bump." --label chore

Merge the bump PR:

gh pr merge --squash --delete-branch --admin

Return to main:

git checkout main && git pull

Versioning Rules

• Follows MAJOR.MINOR.PATCH (e.g., 0.1.16)
• Releases are git tags (v0.1.16) with matching GitHub releases
• The version in pyproject.toml on main is always the next unreleased version
• Consumers pin to a tag (e.g., pip install ... @v0.1.16)
• Bump commit message: chore: bump version to X.Y.Z
• Bump PRs are labeled chore and merged with --admin