version

Analyze code changes to bump semantic versions and create annotated git tags.

Updated Feb 17, 2026
One-click install
npx skills add https://github.com/janewilkin/bismuth-digital-llc-web --skill version-janewilkin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: version
Source: https://github.com/janewilkin/bismuth-digital-llc-web/tree/main/.claude/skills/version
Command: npx skills add https://github.com/janewilkin/bismuth-digital-llc-web --skill version-janewilkin

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the process of managing semantic versioning for a project, ensuring consistency and reducing manual errors in version updates and git tagging.

Core Features & Use Cases

  • Automated Version Bumping: Analyzes code changes to suggest or automatically apply major, minor, or patch version increments.
  • Version File Updates: Modifies version numbers in specified project files (pyproject.toml, __init__.py).
  • Git Tagging: Creates and pushes annotated git tags for new releases.
  • Use Case: After merging new features and bug fixes, run this Skill to automatically determine the next version number, update all relevant files, commit the changes, and create a git tag for the release.

Quick Start

Run the version skill to automatically determine and apply the next version bump.

Frequently Asked Questions about version

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate semantic versioning for a Python project?

Automate semantic versioning by analyzing code changes to suggest version increments, updating version files like pyproject.toml and __init__.py, and creating annotated git tags for releases.

How does conventional commit parsing determine the next version bump?

Conventional commit parsing analyzes commit messages to automatically determine whether a major, minor, or patch version increment is needed based on the nature of the merged code changes.

Can I update pyproject.toml and __init__.py version numbers automatically?

Yes, the versioning process automatically modifies version numbers in specified project files, specifically integrating with pyproject.toml and Python package __init__.py files to ensure consistency.

What is the best way to create annotated git tags for software releases?

Create annotated git tags for releases by running an automated versioning process that determines the next version, updates relevant files, commits the changes, and pushes the git tag.

Does this semantic versioning tool ensure worktree safety during version updates?

Yes, the versioning process ensures worktree safety when analyzing code changes and applying version increments to prevent conflicts or data loss during the automated release workflow.