bump

Bump package.json versions, update changelogs, and create GitHub releases.

19|4|Updated Jan 25, 2026
One-click install
npx skills add https://github.com/GeoloeG-IsT/agents-reverse-engineer --skill bump-geoloeg-ist
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bump
Source: https://github.com/GeoloeG-IsT/agents-reverse-engineer/tree/main/.agents/skills/bump
Command: npx skills add https://github.com/GeoloeG-IsT/agents-reverse-engineer --skill bump-geoloeg-ist

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeping software versions in sync across package.json, CHANGELOG.md, and release tags is error-prone and time-consuming. This Skill automates the entire release workflow, ensuring consistency and reducing manual toil.

Core Features & Use Cases

  • Bump the project version in package.json to the specified semver.
  • Update CHANGELOG.md and README.md to reflect the new release.
  • Create a git tag and publish a gitHub release, optionally pushing to a remote.
  • Validate prerequisites and provide clear error guidance for failed releases.

Quick Start

Provide a new version (e.g., 1.2.3) to bump the project, update the changelog/README, tag the release, and push to GitHub.

Frequently Asked Questions about bump

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

FAQPage Schema
How do I automate version bumping across package.json, CHANGELOG.md, and git tags?

Automate version bumping by applying a specified semver to package.json, updating CHANGELOG.md and README.md, creating a git tag, and publishing a GitHub release. This ensures consistent release metadata across multi-file projects.

Can I publish a GitHub release and push tags directly from my main branch?

Yes, you can publish a GitHub release and push tags directly from your main branch. The workflow requires an authenticated gh CLI and a valid semver version to operate, validating prerequisites and providing clear error guidance for failed releases.

What do I need to set up before automating my software release workflow?

Before automating your software release workflow, you need an authenticated gh CLI, a valid semver version, and your project must be on the main branch. These prerequisites ensure the release process can successfully tag and push to GitHub.

How does an automated changelog update work when bumping project versions?

Automated changelog updates work by synchronizing release notes with the newly specified semver version. When you bump the project version, the workflow automatically updates CHANGELOG.md and README.md to reflect the new release details.

Why does my automated release workflow fail when pushing to GitHub?

Your automated release workflow may fail if prerequisites are unmet, such as lacking an authenticated gh CLI, providing an invalid semver version, or not operating on the main branch. The workflow provides clear error guidance for failed releases.

What is the best way to keep release metadata consistent across multi-file projects?

The best way to keep release metadata consistent is to automate the end-to-end release workflow. This applies a single semver version across package.json, documentation, and git tags, eliminating manual toil and synchronization errors.