next-version

Validate and commit a new project_version in .paadhai.json after user approval.

1|Updated Apr 7, 2026
One-click install
npx skills add https://github.com/learnzdevelopmenthub/paadhai --skill next-version
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: next-version
Source: https://github.com/learnzdevelopmenthub/paadhai/tree/main/.claude/skills/next-version
Command: npx skills add https://github.com/learnzdevelopmenthub/paadhai --skill next-version

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Eliminates manual project version updates by validating the new major version, gating with confirmation, and committing the change consistently through .paadhai.json.

Core Features & Use Cases

  • Config-driven validation: Reads .paadhai.json, displays the current project_version, and ensures the new version is valid semver and greater than the existing one.
  • Controlled execution: Summarizes the impact, waits for explicit approval, updates the config, and commits the version bump.
  • Planning handoff: Offers a clean next step by prompting users to continue with /project-plan and /release-plan without running them automatically.

Quick Start

Run /next-version to validate, update, and commit a new project_version before moving forward with planning.

Frequently Asked Questions about next-version

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

FAQPage Schema
How do I safely bump a project version in a config file without manual errors?

To safely bump a project version, this skill reads .paadhai.json, validates the new version against semver rules, requires human approval, and commits the updated config. It eliminates manual errors by ensuring the new version is greater than the current one before committing.

How does semver validation work when updating project config versions?

Semver validation works by reading the current project_version from .paadhai.json and checking that the proposed new version is valid semver and strictly greater than the existing one. The skill blocks the update and will not commit if the version is invalid or lower.

What's the best way to automate project version bumps before starting release planning?

The best way to automate version bumps is running /next-version. It summarizes the version impact, waits for explicit user confirmation, updates .paadhai.json, creates a git commit, and prompts you to continue with project and release planning skills.

Do I need git access to update the project version in .paadhai.json?

Yes, you need git access to update the project version. The skill requires access to git and the repository config to update .paadhai.json and create a version bump commit after receiving explicit user confirmation.

Can I use this version bump skill with any project config format?

No, you cannot use this skill with any project config format. It specifically reads and updates the project_version field within the .paadhai.json config file as part of the Paadhai pipeline, and does not support other configuration formats.

Why does the version bump process require human approval before committing?

The version bump process requires human approval to provide controlled execution. After displaying the current version and summarizing the impact, the skill waits for explicit confirmation before updating the config and committing, preventing unintended major version changes.