Claude Skills
CollectionsCompareWorkflowsNominate
Sign inSign up
© 2026 Curated Agent Skills·Learn more about Agent Skills
Back to repository

version-bump

verified

Calculate semantic version bumps for any project type using version file adapters

View on GitHub

Marketplace

agent-skills-marketplace

jayteealao/agent-skills

Plugin

release-automation

automation

Repository

jayteealao/agent-skills

plugins/release-automation/skills/version-bump/SKILL.md

Last Verified

February 1, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/jayteealao/agent-skills/blob/main/plugins/release-automation/skills/version-bump/SKILL.md -a claude-code --skill version-bump

Installation paths:

Claude
.claude/skills/version-bump/
Powered by add-skill CLI

Instructions

# 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

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
12338 chars