Calculate semantic version bumps for any project type using version file adapters
View on GitHubjayteealao/agent-skills
release-automation
plugins/release-automation/skills/version-bump/SKILL.md
February 1, 2026
Select agents to install to:
npx add-skill https://github.com/jayteealao/agent-skills/blob/main/plugins/release-automation/skills/version-bump/SKILL.md -a claude-code --skill version-bumpInstallation paths:
.claude/skills/version-bump/# Version Bump ## Purpose Reads the current version from any project type (Node.js, Python, Rust, Go, Java, generic, Claude Code plugins), analyzes git commits since the last release tag, and calculates the appropriate semantic version bump (major/minor/patch) based on conventional commit patterns. Supports multiple version files kept in sync. ## Input Context Requires: - **Project Configuration**: Output from `detect-project-type` skill - **Version Type** (optional): "major", "minor", "patch", or "auto" (default) ## Workflow ### 1. Load Project Configuration Use configuration from `detect-project-type`: - Project type - Version file paths and adapters - Tag pattern - Conventional commits enabled/disabled ### 2. Read Current Version Use the Read tool to read the primary version file and extract the version. See [Version Adapters Reference](../../docs/version-adapters.md) for detailed adapter implementations. **For JSON files (package.json, plugin.json):** 1. Use Read tool to read the JSON file 2. Parse JSON content to extract the "version" field value 3. Store the extracted version as current_version **For TOML files (Cargo.toml, pyproject.toml):** 1. Use Read tool to read the TOML file 2. For Cargo.toml: Search for line starting with "version = " in the [package] section 3. For pyproject.toml: Search in [project] or [tool.poetry] section for "version = " 4. Extract the version value from between the quotes 5. Store as current_version **For Python __version__.py files:** 1. Use Read tool to read the __version__.py file 2. Search for line starting with "__version__ = " 3. Extract the version string from between the quotes 4. Store as current_version **For text files (VERSION, version.txt):** 1. Use Read tool to read the file 2. The entire file content (with whitespace trimmed) is the version 3. Store as current_version **For Gradle files:** 1. Use Read tool to read gradle.properties or build.gradle 2. For gradle.properties: Search for line "version=" an