# product-changelog

product-changelog helps turn product changes into readable changelogs and release notes, with guidance on categories, user-facing copy, visuals, versions, and distribution.

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

## What it does

This skill turns product changes into entries written for users. It covers categories such as New, Improved, Fixed, Removed, and Security, then structures each entry around what people can do, how the change works, and what is different. It also outlines changelog page structure, versioning with SemVer or dates, and handling for breaking changes.

Visual updates can use `belt app run` commands for screenshots, before-and-after comparisons, annotated images, and announcement banners. The material also covers distribution through a changelog page, in-app notices, email, blog posts, social media, and community channels.

The visual workflows require the `belt` CLI and a completed `belt login`. If `belt` is not available, those visual generation steps will not run.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add 101-skills/superpowers --skill product-changelog -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add 101-skills/superpowers --skill product-changelog -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add 101-skills/superpowers --skill product-changelog -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install 101-skills/superpowers guides/product/product-changelog
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add 101-skills/superpowers --skill product-changelog -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/101-skills/superpowers --path guides/product/product-changelog
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add 101-skills/superpowers --skill product-changelog -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/101-skills/superpowers/tree/HEAD/guides/product/product-changelog/SKILL.md

## When to use it
- write a user-facing entry for a new feature
- classify changes as New, Improved, Fixed, or Removed
- explain a breaking change with migration steps
- choose a visual for a UI update
- adapt release notes for several distribution channels

## Example prompts
- Write a changelog entry that explains what users can do with the new feature.
- Classify these changes as New, Improved, Fixed, or Removed and rewrite them for users.
- Create a feature announcement visual with `belt app run` and include it in the release notes.

## Similar
- [changelog-writer](https://affpapa.org/en/nevibecode/skills/changelog-writer.md) — skill · 631 installs
- [changelog-maintenance](https://affpapa.org/en/nevibecode/skills/changelog-maintenance.md) — skill · 503 installs
- [changelog-automation](https://affpapa.org/en/nevibecode/skills/changelog-automation.md) — skill · 13733 installs
- [changelog-writing](https://affpapa.org/en/nevibecode/skills/changelog-writing.md) — skill · 13400 installs
- [changelog-generator](https://affpapa.org/en/nevibecode/skills/changelog-generator.md) — skill · 618 installs
- [changelog](https://affpapa.org/en/nevibecode/skills/itechmeat-changelog.md) — skill · 192 installs

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