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:

Installs
69
Repository
lelborn/skills
First Seen
Jul 20, 2026