release-cut

Automate local release preparation by updating CHANGELOG.md, bumping package.json, and pushing version tags.

3|1|Updated Apr 17, 2026
One-click install
npx skills add https://github.com/BlackBeltTechnology/pi-anthropic-messages --skill release-cut-blackbelttechnology
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: release-cut
Source: https://github.com/BlackBeltTechnology/pi-anthropic-messages/tree/main/.pi/skills/release-cut
Command: npx skills add https://github.com/BlackBeltTechnology/pi-anthropic-messages --skill release-cut-blackbelttechnology

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the local preparation of a pi-anthropic-messages release by promoting the Unreleased section in CHANGELOG.md, bumping package.json, and creating and pushing version tags to trigger CI workflows.

Core Features & Use Cases

  • Automates pre-flight checks (clean working tree, correct branch, up-to-date with origin, type-check).
  • Bumps version and updates CHANGELOG in a coordinated release flow.
  • Creates and pushes git tags to trigger CI workflows without manual steps.
  • Provides guardrails and clear human checkpoints to prevent accidental releases.
  • Use Case: A maintainer says "cut a release" and the skill prepares a new npm package version and draft GitHub Release.

Quick Start

Trigger the release-cut skill to perform a local release cut after confirming pre-flight checks pass.

Frequently Asked Questions about release-cut

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

FAQPage Schema
How do I automate npm package release preparation with changelog and git tag updates?

Automate npm package release preparation by promoting the Unreleased section in CHANGELOG.md, bumping the version in package.json, and pushing a git tag to trigger CI workflows. This coordinates pre-flight checks, version selection, and post-push instructions in a single flow.

What pre-flight checks are required before cutting a release and pushing a version tag?

Pre-flight checks required before cutting a release include verifying a clean working tree, confirming the correct branch, ensuring the local repository is up-to-date with the origin, and passing type-checking. These guardrails prevent accidental or broken releases.

Can I use this automated release flow to create a draft GitHub Release and npm version?

Yes, you can use this automated release flow to prepare a new npm package version and draft a GitHub Release. It bumps the package version, updates the changelog, and pushes a git tag to trigger the necessary CI workflows automatically.

How do I trigger an automated version bump and changelog update using natural language?

Trigger the automated version bump and changelog update by requesting a release with phrases like "cut a release", "release vX.Y.Z", or "tag a release". The skill coordinates the entire local release preparation process from there.

Does the release automation enforce a clean working tree before committing and tagging?

Yes, the release automation enforces a clean working tree before committing and tagging. It also checks that you are on the proper branch, are up-to-date with origin, and pass type-checking to ensure safe version bumps.

What are the limitations of automating git tag creation and package versioning locally?

A limitation of automating git tag creation and package versioning locally is that it requires strict pre-flight guardrails, including a clean working tree and up-to-date branch status, to prevent pushing broken or accidental releases to trigger CI.