version-bump

Automate semantic version bumps across marketplace.json and plugin.json files.

137|20|Updated Jun 13, 2025
One-click install
npx skills add https://github.com/NikiforovAll/claude-code-rules --skill version-bump-nikiforovall
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: version-bump
Source: https://github.com/NikiforovAll/claude-code-rules/tree/main/.claude/skills/version-bump
Command: npx skills add https://github.com/NikiforovAll/claude-code-rules --skill version-bump-nikiforovall

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill automates the complex and error-prone process of updating version numbers across multiple files in a monorepo. It ensures consistent versioning according to semantic versioning rules, integrates changelog updates, and eliminates manual errors during release preparation, saving significant time and effort.

Core Features & Use Cases

  • Atomic Version Updates: Synchronizes version numbers across marketplace.json and all individual plugin.json files.
  • Semantic Versioning Support: Handles major, minor, and patch version increments automatically.
  • Changelog Integration: Prompts for release notes and automatically updates the CHANGELOG.md file.
  • Use Case: Before deploying a new release of your AI plugins, simply instruct Claude to "bump the minor version and add 'new agent features' to the changelog," and it will handle all necessary file modifications and consistency checks.

Quick Start

Execute a patch version bump

python .claude/skills/version-bump/scripts/bump_version.py patch

Frequently Asked Questions about version-bump

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

FAQPage Schema
How do I automate version bumping across multiple JSON files in a monorepo?

Version bumping automates updating version numbers consistently across marketplace.json and plugin.json files simultaneously. This Skill applies semantic versioning rules (major, minor, patch), validates cross-file consistency, and updates CHANGELOG.md in one operation, eliminating manual synchronization errors.

Can I bump versions while automatically updating the changelog?

Yes. This Skill prompts you for release notes during the bump operation and atomically updates CHANGELOG.md alongside all version references. You specify the bump type (patch, minor, major) and changelog content in a single command.

What's the best way to ensure version consistency across plugin.json and marketplace.json?

Semantic versioning consistency is enforced by parsing both marketplace.json and all per-plugin plugin.json files, validating that versions match before applying changes, and updating them atomically. This prevents drift between plugin definitions and the marketplace manifest.

Does this work for monorepos with multiple plugins?

Yes. This Skill discovers all plugins listed in marketplace.json, reads each plugin.json file individually, and synchronizes version updates across the entire monorepo structure, handling arbitrary plugin counts.

What happens if version numbers are inconsistent before I bump?

The Skill validates cross-file version consistency before applying any changes and reports inconsistencies, preventing incomplete or broken releases. You must resolve conflicts before the bump proceeds.

Can I preview changes before committing version updates?

The Skill reports final results and next steps after updating versions and changelog. Review the git diff before pushing to verify all changes across marketplace.json, plugin.json files, and CHANGELOG.md match your intent.