# release-notes

Automates writing and updating release notes in whatsNew.ts with entries for features, improvements, and bug fixes. Pulls data from conversation context, git branches, or Linear issues.

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

## What it does

This skill manages `src/ts/docs/help/whatsNew.ts`, the release notes file. Add individual entries—a feature, improvement, or fix—or generate an entire release from Linear tasks. The skill filters out internal work and alpha-version bugs, organizes content by type, and applies the correct TypeScript structure and formatting.

It understands the file layout: where sections like “Quality of Life Improvements” and “Bug Fixes” live, how to format headers, images, links, and contributor credits. When a release spans multiple Linear issues, the skill merges their children by type while preserving order. QoL improvements sort automatically by impact, from major capabilities down to small polish.

Requires access to project files and a Linear API key if generating from Linear tasks.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install anyproto/anytype-ts .claude/skills/release-notes
```

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

### Gemini CLI

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

2. **Platform CLI**
```bash
gemini skills install https://github.com/anyproto/anytype-ts --path .claude/skills/release-notes
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add anyproto/anytype-ts --skill 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/anyproto/anytype-ts/tree/HEAD/.claude/skills/release-notes/SKILL.md

## When to use it
- assemble release notes from multiple Linear issue parts
- add a feature, improvement, or bug fix to whatsNew.ts with correct formatting
- filter out internal work and bugs from alpha builds
- sort quality-of-life improvements by impact

## Example prompts
- Add the feature 'New notification system' to the current release
- /release-notes from-parent JS-8571 JS-8672
- /release-notes fix "Editor & Blocks" Fixed crash when inserting large blocks

## Similar
- [deliver-release-notes](https://affpapa.org/en/nevibecode/skills/deliver-release-notes.md) — skill · 843 installs
- [release-notes-composer](https://affpapa.org/en/nevibecode/skills/release-notes-composer.md) — skill · 134 installs
- [playwright-release-notes](https://affpapa.org/en/nevibecode/skills/playwright-release-notes.md) — skill · 130 installs
- [update-release-notes](https://affpapa.org/en/nevibecode/skills/update-release-notes.md) — skill · ★ 51527 repo stars
- [release-notes-showcase](https://affpapa.org/en/nevibecode/plugins/release-notes-showcase.md) — plugin · ★ 41430 repo stars
- [create-release-note](https://affpapa.org/en/nevibecode/commands/create-release-note.md) — command · ★ 2744 repo stars

## Other versions with the same name
- [release-notes · phuryn](https://affpapa.org/en/nevibecode/skills/release-notes.md) — 3100 installs
- [release-notes · kenryu42](https://affpapa.org/en/nevibecode/skills/kenryu42-release-notes.md) — ★ 2088 repo stars
- [release-notes · justxor](https://affpapa.org/en/nevibecode/skills/justxor-release-notes.md) — ★ 353 repo stars
- [release-notes · garrytan](https://affpapa.org/en/nevibecode/skills/garrytan-release-notes.md) — ★ 172 repo stars

---
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
