semantic-versioning
This skill equips AI agents to handle version management workflows by applying semantic versioning conventions to your release pipeline. Streamline version bumping, changelog generation, and release tagging—letting your automation handle the repetitive parts of version control so your team focuses on what matters.
semantic-versioning automates version bumping by analyzing your commit history and applying semantic versioning conventions. When you use conventional commits (feat:, fix:, BREAKING CHANGE:), the skill determines whether to increment the major, minor, or patch version number automatically. Tools like semantic-release and standard-version integrate with your CI/CD pipeline to calculate the next version, create git tags, and trigger releases without manual intervention.
AI-generated summary based on this skill's SKILL.md
Install
BagelHole/DevOps-Security-Agent-Skills/semantic-versioning · repository language: Shell
git clone https://github.com/BagelHole/DevOps-Security-Agent-Skills
cp -r DevOps-Security-Agent-Skills/devops/release/semantic-versioning ~/.claude/skills/semantic-versioningFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How does semantic-versioning automate version bumping?
semantic-versioning automates version bumping by analyzing your commit history and applying semantic versioning conventions. When you use conventional commits (feat:, fix:, BREAKING CHANGE:), the skill determines whether to increment the major, minor, or patch version number automatically. Tools like semantic-release and standard-version integrate with your CI/CD pipeline to calculate the next version, create git tags, and trigger releases without manual intervention.
What is the relationship between conventional commits and version increments in semantic-versioning?
semantic-versioning uses conventional commits to determine version increments by mapping commit types to semver changes. A 'fix:' commit triggers a patch bump, a 'feat:' commit triggers a minor bump, and a commit with 'BREAKING CHANGE:' in the footer triggers a major bump. This standardized commit format allows semantic-versioning to parse your git history automatically and calculate the correct version number without ambiguity or manual decision-making.
Can semantic-versioning generate changelogs automatically from commit history?
Yes, semantic-versioning generates changelogs automatically from your commit history by extracting and organizing conventional commits. Tools configured through this skill parse commits since the last release, group them by type (features, fixes, breaking changes), and format them into a readable changelog. This changelog generation happens as part of the automated release process, ensuring your release notes always reflect the actual changes in each version.
How do you set up a CI/CD release pipeline using semantic-versioning?
semantic-versioning enables CI/CD release pipeline setup by configuring tools like semantic-release or standard-version to run on your repository. You define rules for when releases should trigger (typically on commits to your main branch), and the skill handles version calculation, changelog generation, git tagging, and package publishing automatically. The pipeline integrates with your version control system to detect changes and orchestrate the entire release workflow without manual steps.
Does semantic-versioning support managing versions across multiple packages?
semantic-versioning supports multi-package version management through tools like Lerna and Changesets. These tools allow you to manage interdependent packages within a monorepo, coordinating version bumps across packages and tracking which packages changed in each release. This is particularly useful for projects with multiple related packages that need to stay synchronized or have independent versioning strategies.
What are the major, minor, and patch versioning rules in semantic-versioning?
semantic-versioning follows these semver rules: a major version bump (X.0.0) indicates breaking changes, a minor version bump (x.Y.0) indicates new backward-compatible features, and a patch version bump (x.y.Z) indicates backward-compatible bug fixes. The skill applies these rules automatically based on your conventional commits, so 'BREAKING CHANGE:' commits increment major, 'feat:' commits increment minor, and 'fix:' commits increment patch versions.
SKILL.md
rendered from the published skill — quoted content, verbatim
Semantic Versioning
Automate version management and changelog generation following SemVer principles.
When to Use This Skill
Use this skill when: - Implementing version numbering standards - Automating release versioning - Generating changelogs automatically - Setting up release pipelines - Managing package versions
Prerequisites
- Git repository with commit history
- Node.js (for most tools)
- Conventional commits (recommended)
Semantic Versioning Basics
Version Format
MAJOR.MINOR.PATCH[-PRERELEASE][+BUILD]
Examples:
1.0.0
2.1.3
1.0.0-alpha.1
1.0.0-beta.2+build.123
Version Components
| Component | When to Increment |
|---|---|
| MAJOR | Breaking changes (incompatible API changes) |
| MINOR | New features (backward compatible) |
| PATCH | Bug fixes (backward compatible) |
| PRERELEASE |
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 1 file
devops/release/semantic-versioning/SKILL.md