# update-release-notes

update-release-notes — a skill that maintains the release notes file next.mdx in the tldraw repo: collects PRs since the last release and archives next.mdx to a versioned file when a new version ships.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · ★ 51527 repo stars
- Author: tldraw
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/tldraw/tldraw/tree/HEAD/skills/update-release-notes/SKILL.md
- Updated: 2026-10-24
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/update-release-notes

## What it does

The skill works with a local clone of `tldraw/tldraw` and updates `apps/docs/content/releases/next.mdx`. It determines where to pull changes from: `main` (three weeks of development) or `production` (freeze week before release). In the first case, it gathers PRs via `git cherry` from the last tag; in the second, it compares patches between `production` and the previous release branch to include only hotfixes that made it to production.

Internally, bash scripts call `git` and `gh` to retrieve PR lists, details, and branch status. The skill distinguishes commits without PR numbers (hotfixes) and searches for them via `sdk-hotfix-please` labels. Without a clone of the repo in `/tmp/tldraw`, the skill will not run.

When a new version is published, the skill copies `next.mdx` to a file named `vX.Y.0.mdx`, updates the releases index in `releases.mdx`, and clears `next.mdx` for the next cycle. It removes PRs from the notes that were accumulated from `main` but did not reach `production` — those are deferred to the next release.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add tldraw/tldraw --skill update-release-notes -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add tldraw/tldraw --skill update-release-notes -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add tldraw/tldraw --skill update-release-notes -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install tldraw/tldraw skills/update-release-notes
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add tldraw/tldraw --skill update-release-notes -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/tldraw/tldraw --path skills/update-release-notes
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add tldraw/tldraw --skill update-release-notes -a opencode
```

### 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/tldraw/tldraw/tree/HEAD/skills/update-release-notes/SKILL.md

## When to use it
- update next.mdx with merged PRs since last release
- archive next.mdx to a versioned file after a release
- filter out PRs that did not reach production after freeze
- find hotfixes without PR numbers via gh and labels
- sync release notes between main and production branches

## Example prompts
- Check the release cycle status for tldraw and tell me which branch to gather changes from
- Collect new PRs into next.mdx for tldraw since the last tag
- Archive next.mdx to v4.5.0.mdx and update the releases index

## Similar
- [jackin-release-notes](https://affpapa.org/en/nevibecode/skills/jackin-release-notes.md) — skill · 469 installs
- [release-notes-composer](https://affpapa.org/en/nevibecode/skills/release-notes-composer.md) — skill · 134 installs
- [generate-release-notes](https://affpapa.org/en/nevibecode/skills/teambit-generate-release-notes.md) — skill · ★ 18508 repo stars
- [update-infos-release](https://affpapa.org/en/nevibecode/commands/update-infos-release.md) — command · ★ 6529 repo stars
- [draft-release-notes](https://affpapa.org/en/nevibecode/skills/draft-release-notes-2.md) — skill · ★ 11819 repo stars
- [release-notes](https://affpapa.org/en/nevibecode/skills/garrytan-release-notes.md) — skill · ★ 172 repo stars

From the same set: [tldraw/tldraw](https://affpapa.org/en/nevibecode/by/tldraw/tldraw.md) — 12 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
