| name | release |
| description | Create a new GitHub release with version tag and release notes. Determines the next version, verifies main, tags, and creates a GitHub release. Examples: 'create a release', 'release v0.15.0', 'cut a new version'. |
Release
Create a versioned GitHub release on main with auto-generated release notes.
Workflow
1. Check Current Version
git tag --sort=-v:refname | head -5
2. Ensure Main is Clean
git checkout main && git pull
git status
3. Run Verify
Run the verify skill on main. Do not release if any checks fail.
4. Determine Next Version
This repo follows semver v0.MINOR.PATCH:
- Patch bump (v0.14.16 → v0.14.17): Bug fixes, dependency bumps, small improvements
- Minor bump (v0.14.x → v0.15.0): New packages, breaking API changes, significant features
Most releases are patch bumps. Ask the user if unclear.
5. Generate Release Notes
Review commits since the last release to build release notes:
git log --oneline <previous-tag>..HEAD
Organize into categories based on commit prefixes:
- Features —
Add commits (new packages, capabilities)
- Fixes —
Fix commits (bug fixes)
- Dependencies —
Bump commits (dependency updates)
- Improvements — , , commits (refactors, enhancements)