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.