version-bumper

Solid

Suggest the next semantic version and release tag from Conventional Commits in git history. Script bumper.py reads git log subjects (fallback: COMMITS env or --commits FILE for testability), classifies commit types (feat->MINOR, fix/perf/refactor->PATCH, `!` or BREAKING CHANGE->MAJOR) and prints latest_tag, next_version, suggested_tag (e.g. v1.5.0) and counts by type. Pure Python 3 stdlib, offline, deterministic output (-s), read-only (never creates tags). Closes the loop for commit-message-writer and changelog-generator.

AI & Automation 5 stars 0 forks Updated yesterday MIT

Install

View on GitHub

Quality Score: 80/100

Stars 20%
26
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Version Bumper — semantic version from Conventional Commits Load this skill when you need to **compute the next semantic version and a suggested release tag from the commit history** of a git repository that follows [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/). It is the release-pipeline counterpart of `commit-message-writer` (writes the commits) and `changelog-generator` (renders the changelog): this skill decides what version number the changelog and the release tag should carry. The tool is **read-only and offline**: it never creates tags, never writes files, and makes no network calls. It reads `git log` subjects, classifies each commit by type, and prints the current version, the next version and a suggested tag. For testability the commit list can be fed from the `COMMITS` environment variable or a file (`--commits FILE`, one subject per line) — no git repository required. --- ## The bumper script `scripts/bumper.py` — pure Python 3 stdlib (no dependencies). | Source of commits | Command | |---|---| | Git repository (default) | `python3 bumper.py --path /path/to/repo` | | Explicit current version | `python3 bumper.py --path . --current 1.2.3` | | Latest semver tag | `python3 bumper.py --path . --from-tags` | | File (no git needed) | `python3 bumper.py --commits commits.txt --current 1.2.3` | | Environment (no git needed) | `COMMITS='feat: a\nfix: b' python3 bumper.py --current 1.2.3` | ### Bump rules (Conventional Commits v1.0.0) | Si...

Details

Author
bestdeejay-design
Repository
bestdeejay-design/agent-skills
Created
1 weeks ago
Last Updated
yesterday
Language
Python
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category