# Hunk Release

Prepares, publishes, verifies, and curates Hunk releases.

- Repository: https://github.com/modem-dev/hunk (9733 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add modem-dev/hunk --skill hunk-release -g -a claude-code -y`
Codex: `npx skills add modem-dev/hunk --skill hunk-release -g -a codex -y`
Cursor: `npx skills add modem-dev/hunk --skill hunk-release -g -a cursor -y`
Gemini CLI: `npx skills add modem-dev/hunk --skill hunk-release -g -a gemini-cli -y`

## Description

Prepares, publishes, verifies, and curates Hunk releases. Use for release metadata, benchmarks, tags, publishing, release videos, backports, or recovery.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Hunk release workflow

Maintainer-focused and source-checkout only. The tag workflow publishes `hunkdiff` plus five platform packages, attests the binary archives, and creates the GitHub release.

## Safety

- Ask when the version, release branch, previous tag, or channel is ambiguous.
- Get explicit confirmation before pushing a tag, triggering publication, or editing a public release.
- Never reuse an npm version or move a tag after publication.
- Never bypass a benchmark regression without an approved, recorded reason.
- Never retry a partial publish before inventorying every package and artifact.

## 1. Confirm the release

Record the version, tag, branch, previous tag, and expected channel:

- newer stable: npm `latest` and GitHub Latest;
- prerelease: npm `beta`, not GitHub Latest;
- older-series backport: npm `backport-X.Y`, leaving both latest pointers unchanged.

For backports, include only commits present between the previous tag and the release tip on that maintenance branch. Inspect `.changeset/pre.json` before changing prerelease state.

## 2. Prepare

Start from a clean, current release branch:

```sh
git status --short --branch
git fetch origin --tags --prune
git tag --sort=-version:refname | head -10
bun install --frozen-lockfile
bun run changeset:status
```

Read the pending Changesets, then generate metadata and the published release notes:

```sh
bun run release:version
bun run generate:changelog
git diff -- package.json bun.lock packages CHANGELOG.md .changeset website
```

Verify the intended versions, consumed Changesets, and new changelog section. Do not force a bump by hand-editing generated versions.

The rest: https://github.com/modem-dev/hunk/blob/HEAD/skills/hunk-release/SKILL.md