| name | gh-release |
| description | Automates version bumping in pyproject.toml and creating GitHub releases. Use when releasing a new version of the project. |
GitHub Release Skill
Overview
This skill automates the process of creating a new release. It updates the version in pyproject.toml, commits the change, and then creates a GitHub release using the gh CLI tool.
Semantic Versioning (SemVer)
This project follows Semantic Versioning (SemVer) for releasing versions. SemVer uses a MAJOR.MINOR.PATCH format:
- MAJOR version when you make incompatible API changes.
- MINOR version when you add functionality in a backward compatible manner.
- PATCH version when you make backward compatible bug fixes.
Example: 1.0.0 -> 1.1.0 (new feature), 1.1.0 -> 1.1.1 (bug fix), 1.1.1 -> 2.0.0 (breaking change).
Usage
To use this skill, execute the create-release.sh script from the root of your project with the desired new version number as an argument.
Example:
./.agent/skills/gh-release/scripts/create-release.sh 0.1.0
This will perform the following actions:
- Find the
pyproject.toml file in the project root.
- Update the
version field in pyproject.toml to the specified version.
- Stage the
pyproject.toml file.
- Commit the change with the message
chore(release): <version>.
- Create a GitHub release with auto-generated release notes using
gh release create.
Requirements
gh CLI tool must be installed and authenticated.- The script should be run from the root of the project repository.
python must be available (used for safe TOML editing).
Resources
scripts/
create-release.sh: The main script that performs the release automation.
