Agent skill · software engineering · aj-geddes
semantic-versioning
Implement semantic versioning (SemVer) with automated release management. Use conventional commits, semantic-release, and version bumping strategies.
Why this skill is useful
Provides specific automation scripts and configurations for semantic versioning that the AI wouldn't reliably generate on its own.
What it needs
Requires @semantic-release/changelog, @semantic-release/git, @semantic-release/github, conventional-changelog-cli, semantic-release installed locally. About 1k tokens when loaded. Last updated 2026-03-04. 307 stars on the source repository.
What this skill does
Semantic Versioning Table of Contents Overview When to Use Quick Start Reference Guides Best Practices Overview Establish semantic versioning practices to maintain consistent version numbering aligned with release significance, enabling automated version management and release notes generation. When to Use Package and library releases API versioning Version bumping automation Release note generation Breaking change tracking Dependency management Changelog management Quick Start Minimal working example: Reference Guides Detailed implementations in the references/ directory: Guide Contents --- --- Semantic Versioning Configuration Semantic Versioning Configuration Conventional Commits Format Conventional Commits Format Semantic Release Configuration Semantic Release Configuration Version Bumping Script Version Bumping Script Changelog Generation Changelog Generation Best Practices ✅ DO Follow strict MAJOR.MINOR.PATCH format Use conventional commits Automate version bumping Generate changelogs automatically Tag releases in git Document breaking changes Use prerelease versions for testing ❌ DON'T Manually bump versions inconsistently Skip breaking change documentation Use arbitrary version numbering Mix features in patch releases
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aj-geddes/semantic-versioning