harness-release

Automate gated GitHub releases with version detection and changelog promotion.

39|46|Updated May 29, 2026
One-click install
npx skills add https://github.com/maxwell2732/claudecode-research-harness-workflow --skill harness-release-maxwell2732
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: harness-release
Source: https://github.com/maxwell2732/claudecode-research-harness-workflow/tree/main/skills/harness-release
Command: npx skills add https://github.com/maxwell2732/claudecode-research-harness-workflow --skill harness-release-maxwell2732

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Automated release workflows are difficult to audit and reproduce; this skill gates all steps behind a single confirmation to ensure an auditable, repeatable release process.

Core Features & Use Cases

  • End-to-end release planning and execution across version bumps, changelog promotion, PR merges, tagging, and GitHub Release.
  • Preflight checks, version auto-detection across common files, and in-memory draft generation for release notes.
  • Enforce a single final confirmation gate before merging to the default branch and publishing.

Quick Start

Install Claude Code, verify prerequisites (Git, Python, gh CLI), clone this repository, and run the harness with /release to begin the gated release workflow.

Frequently Asked Questions about harness-release

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

FAQPage Schema
How do I automate a GitHub release with a single confirmation gate?

You can automate a GitHub release by running a gated workflow that coordinates version bumps, changelog promotion, PR merges, and tagging behind one confirmation. The process drafts release notes in memory and enforces a post-gate merge requirement before publishing.

How does version auto-detection work for changelog and release workflows?

Version auto-detection works by scanning project files like VERSION, package.json, pyproject.toml, or Cargo.toml to identify the target version. This detected version then coordinates the changelog promotion, tagging, and GitHub Release steps within the gated workflow.

Can I use Keep a Changelog with GitHub to enforce an auditable release process?

Yes, you can use Keep a Changelog with GitHub to enforce an auditable release process. The workflow gates all release steps behind a single confirmation, ensuring version bumps, changelog promotion, and merges are repeatable and trackable before publishing.

Do I need the gh CLI to automate PR merges and GitHub releases?

Yes, you need the gh CLI along with Git and Python to automate PR merges and GitHub releases. These prerequisites allow the workflow to interact with GitHub APIs for merging branches, creating tags, and publishing the final release.

What is the best way to coordinate version bumps and tagging across teams?

The best way to coordinate version bumps and tagging across teams is using an end-to-end release workflow. It auto-detects the target version from project files, drafts changes in memory, and gates the PR merge and tagging behind a single confirmation.

Why should I gate a release workflow behind a single confirmation?

Gating a release workflow behind a single confirmation ensures the process is auditable and reproducible. It prevents accidental publishing by holding version bumps, changelog updates, and PR merges in memory until you explicitly approve the final release.