xerahs-release-bump-tag

Automate release sequencing with build verification, version bumps, and tag creation.

309|15|Updated Dec 29, 2025
One-click install
npx skills add https://github.com/ShareX/XerahS --skill xerahs-release-bump-tag
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: xerahs-release-bump-tag
Source: https://github.com/ShareX/XerahS/tree/main/.ai/skills/xerahs-release-bump-tag
Command: npx skills add https://github.com/ShareX/XerahS --skill xerahs-release-bump-tag

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Orchestrates a strict, end-to-end release workflow to ensure build success before tagging and releasing, reducing manual toil and human error.

Core Features & Use Cases

  • Step 1: automatically perform maintenance chores (git pull --recurse-submodules and git submodule update --init --recursive)
  • Step 2: invoke an optional update-changelog skill to refresh CHANGELOG.md when present
  • Step 3: verify the build, then bump the version, commit changes, push, and create/push a semantic tag
  • Step 4: monitor the GitHub Actions release workflow every 2 minutes until completion
  • Step 5: on failure, inspect logs, fix root cause, and retry with the next patch version
  • Step 6: optionally mark the release as a prerelease

Quick Start

From the repository root, run the release sequence script at .ai/skills/xerahs-release-bump-tag/scripts/run-release-sequence.sh to start the automated flow.

Frequently Asked Questions about xerahs-release-bump-tag

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

FAQPage Schema
How do I automate git release tagging and version bumping in CI/CD pipelines?

Automated release sequencing orchestrates end-to-end git workflows by verifying builds, bumping versions, committing changes, pushing, and creating semantic tags. It reduces manual toil and ensures build success before tagging and releasing across CI pipelines.

What steps are required for an automated software release workflow with build verification?

The release workflow performs maintenance chores, updates the changelog, verifies the build, bumps the version, commits, pushes, and creates a tag. It then monitors the GitHub Actions release workflow every 2 minutes until completion.

Does this release automation work with Directory.Build.props for version synchronization?

Yes, the release automation satisfies guardrails for version synchronization across Directory.Build.props files. It ensures version numbers are consistently updated before committing changes and pushing the semantic tag.

What happens if a GitHub Actions release workflow fails during automated tagging and deployment?

When the monitored GitHub Actions release workflow fails, the sequence inspects logs, fixes the root cause, and retries the process with the next patch version. This retry logic ensures safe release sequencing without manual intervention.

Can I mark an automated release as a prerelease during the version bump sequence?

Yes, you can optionally mark the release as a prerelease during the sequence. After build verification, version bumping, and tag creation, the workflow supports optional prerelease marking to manage pre-production distributions.

How do I handle git submodules during an automated release and version bump?

The release sequence automatically performs maintenance chores by running git pull --recurse-submodules and git submodule update --init --recursive. This ensures all submodules are properly initialized before build verification and tagging.