version-management

vanman2024's avatarfrom vanman2024

Semantic versioning helpers and release scripts. Use when managing versions, bumping version numbers, creating releases, generating changelogs, or when user mentions versioning, semantic versioning, release management, version bumps, or semver.

⭐0stars🔀0forks📁View on GitHub🕐Updated Dec 25, 2025
[CI and CD]

When & Why to Use This Skill

This Claude skill automates the software release lifecycle by providing robust tools for semantic versioning (SemVer), automated changelog generation, and release script execution. It simplifies version bumping (major, minor, patch) across multiple configuration files, ensures consistent git tagging, and parses conventional commits to create organized changelogs, significantly reducing manual errors and maintaining consistency in the deployment process.

Use Cases

  • Automating version increments (major, minor, or patch) across multiple project files like package.json, pyproject.toml, or Cargo.toml based on the impact of code changes.
  • Generating professional, categorized changelogs from git commit history using conventional commit parsing to provide clear release notes for stakeholders.
  • Streamlining the release workflow by performing pre-release validations, updating version strings, and creating annotated git tags in a single automated step.
  • Maintaining project metadata consistency by extracting and synchronizing version information across various environment configurations and manifest files.
nameVersion Management
descriptionSemantic versioning helpers and release scripts. Use when managing versions, bumping version numbers, creating releases, generating changelogs, or when user mentions versioning, semantic versioning, release management, version bumps, or semver.
allowed-toolsRead, Write, Edit, Bash

Version Management

This skill provides semantic versioning helpers, version bump scripts, changelog generation, and release management tools.

What This Skill Provides

1. Version Bump Scripts

  • bump-version.sh - Increment version (major/minor/patch)
  • get-version.sh - Extract current version from project files
  • set-version.sh - Update version across all files

2. Changelog Generation

  • generate-changelog.sh - Create changelog from git commits
  • Conventional commit parsing
  • Categorized changes (feat, fix, docs, etc.)

3. Release Scripts

  • create-release.sh - Tag and prepare release
  • validate-release.sh - Check release readiness
  • Git tag creation with annotations

4. Version File Templates

  • package.json version field
  • pyproject.toml version field
  • Cargo.toml version field
  • VERSION file template

Instructions

Bumping Version

When user wants to increment version:

  1. Detect current version from project files
  2. Parse semantic version (MAJOR.MINOR.PATCH)
  3. Increment appropriate component:
    • major: Breaking changes (1.0.0 → 2.0.0)
    • minor: New features (1.0.0 → 1.1.0)
    • patch: Bug fixes (1.0.0 → 1.0.1)
  4. Update all version files

Execute:

!{bash plugins/01-core/skills/version-management/scripts/bump-version.sh major} !{bash plugins/01-core/skills/version-management/scripts/bump-version.sh minor} !{bash plugins/01-core/skills/version-management/scripts/bump-version.sh patch}

Generating Changelog

When user wants changelog:

  1. Get commits since last tag
  2. Parse conventional commit messages
  3. Categorize by type (feat, fix, docs, etc.)
  4. Format as markdown with links

Execute:

!{bash plugins/01-core/skills/version-management/scripts/generate-changelog.sh}

Creating Release

When user wants to create release:

  1. Validate no uncommitted changes
  2. Bump version
  3. Update changelog
  4. Create git commit
  5. Create git tag
  6. Display next steps (push, publish)

Semantic Versioning Rules

MAJOR (X.0.0):

  • Breaking changes
  • Incompatible API changes
  • Major refactoring

MINOR (x.Y.0):

  • New features
  • Backward-compatible additions
  • Deprecations

PATCH (x.y.Z):

  • Bug fixes
  • Performance improvements
  • Documentation updates

Success Criteria

  • ✅ Version follows semver format
  • ✅ All version files updated consistently
  • ✅ Changelog generated from commits
  • ✅ Git tag created with version
  • ✅ Release is reproducible

Plugin: 01-core Skill Type: Helper + Generator Auto-invocation: Yes (via description matching)