release

Automate ButterCut releases with version bumps, changelog, git tags, gem build, and GitHub release.

584|97|Updated Nov 10, 2025
One-click install
npx skills add https://github.com/barefootford/buttercut --skill release-barefootford
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: release
Source: https://github.com/barefootford/buttercut/tree/main/.claude/skills/release
Command: npx skills add https://github.com/barefootford/buttercut --skill release-barefootford

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides through the complete ButterCut release process: version bumps, changelog, git tagging, gem publishing, and GitHub releases.

Core Features & Use Cases

  • Test-first release: Always run tests before releasing. Use:
  • Version management: Inspect current version, bump with semver, and update lib/buttercut/version.rb.
  • Artifacts & Release: Update CHANGELOG.md, create and push git tags, build the gem, publish to RubyGems, and create a GitHub release.

Quick Start

Run the release skill to prepare and publish a new ButterCut version. It will prompt you to specify the release type (MAJOR/MINOR/PATCH) and provide release notes.

Frequently Asked Questions about release

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

FAQPage Schema
How do I automate publishing a Ruby gem release with version bumps and GitHub releases?

The release Skill automates the complete gem publishing workflow by bumping semantic versions, updating CHANGELOG.md, creating git tags, building the gem, publishing to RubyGems, and creating a GitHub release. It handles MAJOR, MINOR, and PATCH increments in one workflow.

What do I need to set up before releasing a gem to RubyGems and GitHub?

Ensure a clean working directory, passing test suite, proper authentication credentials for RubyGems and GitHub, and editable lib/buttercut/version.rb and CHANGELOG.md files. The Skill guides you through version selection and release notes during execution.

Can I use semantic versioning for gem releases with automated changelog updates?

Yes. The Skill applies semantic versioning (MAJOR, MINOR, PATCH) to bump versions in lib/buttercut/version.rb and automatically updates CHANGELOG.md, then creates git tags and publishes the versioned gem to RubyGems and GitHub simultaneously.

How do I ensure my gem release includes proper git tags and GitHub release artifacts?

The release Skill creates and pushes git tags as part of the release process, then generates a corresponding GitHub release with your provided release notes. Both artifacts are created atomically during the publish step.

What happens if my test suite fails before releasing?

The Skill requires a passing test suite before proceeding with the release. You must run tests first and resolve failures; the workflow will not proceed to version bumping, tagging, or publishing until tests pass.

Do I need to manually update version files and changelog before using the release Skill?

No. The release Skill handles updating lib/buttercut/version.rb and CHANGELOG.md automatically based on your chosen MAJOR, MINOR, or PATCH increment. You provide release notes, and the Skill manages the file updates and git operations.