version-bump-advisor

Community

Automate version bumps and changelogs.

Authormurphytrueman
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill eliminates the subjectivity and friction in design system versioning by providing a consistent framework for classifying changes, recommending the correct semantic versioning (semver) bump, and generating a detailed changelog entry with reasoning.

Core Features & Use Cases

  • Automated Semver Classification: Classifies changes into Breaking, Minor, or Patch categories based on strict rules.
  • Changelog Generation: Produces a markdown-formatted, copy-paste-ready changelog entry.
  • Migration Guidance: Provides specific migration notes for breaking changes.
  • Edge Case Handling: Addresses common design system versioning complexities like pre-1.0 releases, deprecations, and CSS specificity changes.
  • Use Case: When preparing a new release, provide the Skill with a git diff or a list of changes, and it will recommend the semver bump (e.g., major, minor, patch), explain the reasoning, and draft the changelog entry.

Quick Start

Use the version-bump-advisor skill to recommend a semver bump for the attached git diff output.

Dependency Matrix

Required Modules

None required

Components

references

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: version-bump-advisor
Download link: https://github.com/murphytrueman/design-system-ops/archive/main.zip#version-bump-advisor

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.