Apply Semantic Versioning

Determine and apply the correct semantic version bump by analyzing changes since the last release. This skill reads version files, classifies changes as breaking (major), feature (minor), or fix (patch), computes the new version number, and updates the appropriate files. Follows SemVer 2.0.0 specification.

When to Use

• Preparing a new release and need to determine the correct version number
• After merging a set of changes and before tagging a release
• Evaluating whether a change constitutes a breaking change
• Adding pre-release identifiers (alpha, beta, rc) to a version
• Resolving disagreement about what version bump is appropriate

Inputs

• Required: Project root directory containing a version file (DESCRIPTION, package.json, Cargo.toml, pyproject.toml, or VERSION)
• Required: Git history since the last release (tag or commit)
• Optional: Commit convention in use (Conventional Commits, free-form)
• Optional: Pre-release label to apply (alpha, beta, rc)
• Optional: Previous version if not readable from files