version-check

Analyze git commits to recommend semantic version bumps for Nimbus releases.

3|Updated Mar 27, 2026
One-click install
npx skills add https://github.com/NimbusPowered/Nimbus --skill version-check-nimbuspowered
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: version-check
Source: https://github.com/NimbusPowered/Nimbus/tree/main/.claude/skills/version-check
Command: npx skills add https://github.com/NimbusPowered/Nimbus --skill version-check-nimbuspowered

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you avoid guessing release versions by analyzing what changed since your last tag and translating that into a correct semver bump.

Core Features & Use Cases

  • Release-version recommendation: Determines major, minor, or patch based on commit history and breaking-change signals.
  • Conventional-commit classification: Maps commit message prefixes and semantics into feature, fix, and breaking categories.
  • Release readiness summary: Produces a clear changelog-style breakdown and a suggested update for gradle.properties.

Quick Start

Ask for a version check by saying: "Run a version check for Nimbus and tell me what semver bump I should release next."

Frequently Asked Questions about version-check

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

FAQPage Schema
How do I determine the correct semantic version bump from git commit history?

To determine the correct semantic version bump, analyze non-merge git commits since the latest v*.*.* tag, classify Conventional Commit semantics including breaking-change detection, and output a major, minor, or patch recommendation.

What is the best way to automate release planning using conventional commits?

Automating release planning with conventional commits involves mapping commit message prefixes into feature, fix, and breaking categories to produce a changelog-style breakdown and validate release readiness before applying a version bump.

How do I check release readiness after merging changes to a project?

Checking release readiness after merging changes requires listing commits since the highest version tag, detecting breaking-change signals, and generating a suggested update for gradle.properties to prepare the new release.

Does semantic-release work with gradle.properties for version validation?

Semantic-release validation integrates with gradle.properties by checking the current nimbusVersion value, comparing it against the recommended semver bump derived from the git commit history analysis.

Why does a breaking change signal a major semver bump instead of a patch?

A breaking change signals a major semver bump because Conventional Commit semantics dictate that any modification breaking backward compatibility requires incrementing the major version instead of minor or patch.

When should I not use an automated semver bump recommendation?

You should avoid relying solely on an automated semver bump recommendation when your git history lacks Conventional Commit prefixes, as the classification logic cannot accurately detect features, fixes, or breaking changes.