han-release

Automates Han plugin releases by updating changelogs, bumping versions, tagging plugins, and publishing GitHub releases.

Updated Sep 1, 2026
One-click install
npx skills add https://github.com/amirbiron/Han --skill han-release-amirbiron
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: han-release
Source: https://github.com/amirbiron/Han/tree/main/.claude/skills/han-release
Command: npx skills add https://github.com/amirbiron/Han --skill han-release-amirbiron

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Cutting a release for a multi-plugin repository involves tedious, error-prone manual work: writing changelog entries, computing semantic version bumps per plugin, creating correctly named git tags, and assembling GitHub release notes with proper attribution. This Skill automates that entire pipeline with mandatory approval gates before any irreversible tag is pushed. ## Core Features & Use Cases - Changelog generation: Updates CHANGELOG.md with a narrative section per release, attributing every change to the plugin whose directory it touched, and crediting PR authors and issue contributors with linked GitHub profiles. - Per-plugin version planning: Computes semantic version bumps (major/minor/patch) for each plugin based on what changed in its directory since the previous release tag, with a confirmation gate when versions need computing. - Safe tagging and publishing: Classifies every tag against the remote (absent, already published, local-only, or colliding), requires explicit approval before creating tags, and publishes a GitHub release with PR and closed-issue attribution. - Use Case: After merging several PRs into the Han repository, run the release skill to generate the v5.1.0 changelog section, bump han-core and han-github versions, tag each changed plugin as {name}--v{version}, and publish the GitHub release notes in one guided flow. ## Quick Start Ask the AI to cut a new Han release from the current repository state, optionally adding the word draft or pause to control publishing behavior.

Frequently Asked Questions about han-release

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

FAQPage Schema
How do I cut a release for a multi-plugin Claude Code repository?▼

Run the release skill from a clean git checkout of the repository. It resolves the previous release tag, collects merged PRs and closed issues, computes per-plugin version bumps, updates CHANGELOG.md, and asks for approval before creating and pushing any tags.

How are semantic version bumps decided for each plugin?▼

Each changed plugin is classified by its diff: removed or renamed skills or agents trigger a major bump, new skills or agents trigger minor, and fixes trigger patch. The parent plugin always bumps, taking the highest level across the whole release.

What tools are required to run this release skill?▼

The skill requires the gh CLI, jq, the claude CLI, and a clean git working tree inside the repository. If any prerequisite is missing, the skill stops immediately and reports which one must be installed.

Can a pushed release tag be moved or deleted if something goes wrong?▼

No. A pushed tag is never moved, which is why the skill always stops for explicit approval before creating tags and classifies every tag against the remote first. If a tag name collides at a different commit, the only recovery is choosing a different version number.

Does the skill work for a first release with no previous tag?▼

Yes. When no previous tag exists, the commit range covers the full history, compare links are omitted from the release notes, and every plugin is treated as new with its current version as the baseline.