semver
Installation
SKILL.md
Semantic Versioning (SemVer 2.0.0)
Decision logic and reference for SemVer 2.0.0. Often consumed by other workflows (the keep-a-changelog and conventional-commits skills) that just need the bump and the reason, so keep answers terse.
A version is a compatibility promise about a declared public API: MAJOR = breaks you, MINOR = new but compatible, PATCH = compatible fixes. Without a declared public API "breaking" is undefined — establish it or ask before deciding.
Format
MAJOR.MINOR.PATCH[-PRERELEASE][+BUILD]
MAJOR.MINOR.PATCH: non-negative integers, no leading zeroes (1.9.0).- Pre-release after
-(1.0.0-alpha.1); build metadata after+(1.0.0+20130313144700). - Pre-release/build identifiers:
[0-9A-Za-z-], dot-separated, non-empty, no leading zeroes on numeric pre-release identifiers.
Deciding the bump
Don't pattern-match "new thing = MINOR." Reason in three steps: