changelog-bump-ver

What I do

• Promote ## [Unreleased] entries in CHANGELOG.md into a new versioned release section
• Create a fresh empty ## [Unreleased] section above the new release
• Preserve Keep a Changelog structure with empty Added, Changed, Deprecated, Removed, Fixed, and Security subsections, and include Misc at the end for this repo's extended template
• Determine the next version using the user's requested bump method when provided
• Otherwise infer the current bump method from existing changelog history and fall back to minor when history is insufficient or unclear
• Use the current system date from date +%F in the new release heading
• Update Java Maven pom.xml files by changing only the direct <project><version> value to the next development snapshot version after the release

When to use me

Use this skill when:

• A project already has a CHANGELOG.md with an ## [Unreleased] section
• You are cutting a new release and want to move unreleased notes into a versioned entry
• You want the skill to keep a fresh empty unreleased template ready for future work
• You want Maven project versions in pom.xml files updated to the next development snapshot after the release

Do not use this skill when:

• The repository does not have a CHANGELOG.md yet; use make-changelog first
• You want to generate release notes from commits automatically
• You want to create git tags, commits, or GitHub releases as part of the same workflow

Prerequisites

Required:

• CHANGELOG.md exists at the repository root
• CHANGELOG.md contains exactly one ## [Unreleased] section

Optional:

• One or more pom.xml files if the project uses Maven

Validation checks:

# Check changelog exists
[ -f CHANGELOG.md ]

# Check unreleased section exists exactly once
[ "$(grep -c '^## \[Unreleased\]$' CHANGELOG.md)" -eq 1 ]

# Get current release date
date +%F

Error messages:

• Missing changelog -> "Error: CHANGELOG.md not found. Create it first before bumping a release."
• Missing unreleased section -> "Error: CHANGELOG.md does not contain a ## [Unreleased] section."
• Multiple unreleased sections -> "Error: Multiple ## [Unreleased] sections found. Normalize the changelog before running this skill."
• No version can be derived -> "Error: Could not determine the next release version from CHANGELOG.md."