Version Management

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)