semantic-versioning

Determine and apply MAJOR, MINOR, or PATCH version bumps in project manifests.

Updated Feb 26, 2026
One-click install
npx skills add https://github.com/heikopanjas/agent-skills --skill semantic-versioning-heikopanjas
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: semantic-versioning
Source: https://github.com/heikopanjas/agent-skills/tree/main/semantic-versioning
Command: npx skills add https://github.com/heikopanjas/agent-skills --skill semantic-versioning-heikopanjas

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

After code changes, determine whether a version bump is required and apply semantic versioning (SemVer) to keep a project's version aligned with its changes.

Core Features & Use Cases

  • Determine the appropriate version bump (Patch, Minor, or Major) based on the type of change and the project's commit conventions.
  • Read the current version from manifests such as Cargo.toml or package.json and apply the correct increment.
  • Integrate the bump into the same commit as the code change and document the change in the commit message.

Quick Start

Run semantic-versioning after code changes to determine and apply the correct SemVer bump in the project's manifest

Frequently Asked Questions about semantic-versioning

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically determine the correct SemVer bump from code changes?

To automatically determine the correct SemVer bump from code changes, the Skill analyzes your modifications and commit conventions to map the change to a MAJOR, MINOR, or PATCH bump. It then reads the current version from your project manifest and applies the increment.

How do I apply a version bump to package.json or Cargo.toml without creating a separate commit?

You can apply a version bump to package.json or Cargo.toml without a separate commit by integrating the version increment directly into your current code change commit. The Skill updates the manifest and records the bump in the same commit message.

When do I need a MINOR versus a PATCH version bump for a software release?

You need a MINOR versus a PATCH version bump when your code changes introduce new backward-compatible functionality rather than a backward-compatible bug fix. The Skill identifies the change type based on your project conventions and maps it to the correct semantic versioning increment.

Does this semantic versioning approach work with both Rust and Node.js project manifests?

Yes, this semantic versioning approach works with both Rust and Node.js project manifests. The Skill reads the current version directly from project manifests such as Cargo.toml or package.json and applies the corresponding version increment.

What is the best way to keep a project's version aligned with code changes during development?

The best way to keep a project's version aligned with code changes is to evaluate modifications after they are made and automatically apply the correct semantic version increment. This ensures the manifest version accurately reflects the nature of the code changes without requiring manual tracking.

What are the limitations of mapping code changes to semantic versioning automatically?

A limitation of mapping code changes to semantic versioning automatically is that the accuracy of the MAJOR, MINOR, or PATCH bump depends heavily on your project's commit conventions. The Skill requires a clear manifest like Cargo.toml or package.json to read and update the current version.