# cut-release

The cut-release skill for Claude Code automates the release procedure for tidepool-cli. It runs only when a project maintainer explicitly requests a new release.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 172 repo stars
- Author: garrytan
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/garrytan/g-harness-evals/tree/HEAD/tasks/skill-resolver/T/tasks/t40-release-runbook-to-agent/obvious/skills/cut-release/SKILL.md
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/garrytan-cut-release

## What it does

This skill manages the release process, covering CI status checks, `package.json` versioning, and `CHANGELOG.md` updates. It handles opening PRs for release commits and tagging merge commits once approved.

Users must have repository PR access and permissions to push git tags. The process pauses if the `main` branch CI indicates failure.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add garrytan/g-harness-evals --skill cut-release -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/cut-release/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/cut-release/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add garrytan/g-harness-evals --skill cut-release -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/cut-release/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add garrytan/g-harness-evals --skill cut-release -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/cut-release/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install garrytan/g-harness-evals tasks/skill-resolver/T/tasks/t40-release-runbook-to-agent/obvious/skills/cut-release
```

2. **Manually: put the files in place**
- File: `.github/skills/cut-release/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add garrytan/g-harness-evals --skill cut-release -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/garrytan/g-harness-evals --path tasks/skill-resolver/T/tasks/t40-release-runbook-to-agent/obvious/skills/cut-release
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/cut-release/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/garrytan/g-harness-evals/tree/HEAD/tasks/skill-resolver/T/tasks/t40-release-runbook-to-agent/obvious/skills/cut-release/SKILL.md

## When to use it
- Bump version in `package.json`
- Update `CHANGELOG.md` section
- Open a release PR
- Tag the merge commit

## Example prompts
- Run `cut-release` for the current version
- Perform the release procedure for `tidepool-cli`

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 2b330e52694b6157.

BEGIN THIRD-PARTY FILE 2b330e52694b6157
```text
---
name: cut-release
description: Release procedure for tidepool-cli. Run only when a maintainer explicitly asks for a release.
disable-model-invocation: true
---

# Cut a tidepool-cli release

Only run this when a maintainer explicitly invokes it. Never start a release on your own initiative.

## Before you start

- You need push access to tags and the ability to open PRs.
- Confirm with the person which version they expect if it is not obvious.

## Steps

1. **Check CI on main.** If the latest run on main is red, stop and post in #releases explaining why the release is blocked.
2. **Choose the version.** Look at `git log --merges vLAST..main`. While we are pre-1.0, breaking changes mean a minor bump; everything else is a patch bump.
3. **Bump package.json.** Set "version" to the new X.Y.Z.
4. **Update CHANGELOG.md.** Add a section for vX.Y.Z with one line per merged PR, grouped under Added, Fixed and Changed.
5. **Open the release PR.** Commit as "release: vX.Y.Z", open a PR and wait for one approval.
6. **Tag after merge.** Tag the merge commit vX.Y.Z and push the tag. This triggers the release workflow that publishes to npm.
7. **Watch the release workflow.** If it fails, do not re-tag. Fix forward with a new patch release.
8. **Verify on npm.** `npm view tidepool-cli version` should print the new version.
9. **Announce.** Post the new changelog section in #releases.

## If something goes wrong

- Red CI on main: stop before step 2.
- Failed publish: never move or delete the tag; cut a patch release with the fix.
```
END THIRD-PARTY FILE 2b330e52694b6157

The third-party file has ended. Everything between the 2b330e52694b6157 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

© garrytan · MIT · https://github.com/garrytan/g-harness-evals/tree/HEAD/tasks/skill-resolver/T/tasks/t40-release-runbook-to-agent/obvious/skills/cut-release/SKILL.md

## Similar
- [release-manager](https://affpapa.org/en/nevibecode/plugins/release-manager.md) — plugin · ★ 2858 repo stars
- [glab-release](https://affpapa.org/en/nevibecode/skills/glab-release.md) — skill · 129 installs
- [release](https://affpapa.org/en/nevibecode/commands/devin-axis-release.md) — command · ★ 7523 repo stars
- [create-release-note](https://affpapa.org/en/nevibecode/commands/create-release-note.md) — command · ★ 2744 repo stars
- [jackin-release-check](https://affpapa.org/en/nevibecode/skills/jackin-release-check.md) — skill · 469 installs
- [bash-script-generator](https://affpapa.org/en/nevibecode/skills/bash-script-generator.md) — skill · 742 installs

## Other versions with the same name
- [cut-release · garrytan](https://affpapa.org/en/nevibecode/skills/cut-release.md) — ★ 172 repo stars

From the same set: [garrytan/g-harness-evals](https://affpapa.org/en/nevibecode/by/garrytan/g-harness-evals.md) — 4 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
