# make-changelog

make-changelog creates or updates CHANGELOG.md from Git history in Keep a Changelog format. Use it when preparing release notes or catching up on missing entries.

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

## What it does

The skill derives version ranges from Git tags and commits, then prepares a section for each range that contains commits. It sorts entries into Added, Changed, Deprecated, Removed, Fixed, and Security, leaving out empty categories. Merge commits, CI/CD configuration, version bumps, and formatting-only changes are skipped.

For an existing `CHANGELOG.md`, you can fill gaps, rebuild the file, or refresh only `[Unreleased]`. If your request could mean more than one of those, the skill asks which approach to use. It runs parallel Haiku subagents, one per non-empty range. When there are more than 12 ranges, you must choose between processing the latest 12 and processing all of them. The range script stops if the repository is invalid or has no commits, so it cannot generate a changelog in that case.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add gupsammy/Claudest
```
In the agent chat (not a shell):
```text
/plugin install claude-coding@Claudest
```
This installs the whole claude-coding plugin with all its skills

2. **Skills CLI (Vercel)**
```bash
npx skills add gupsammy/Claudest --skill make-changelog -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add gupsammy/Claudest --skill make-changelog -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add gupsammy/Claudest --skill make-changelog -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install gupsammy/Claudest plugins/claude-coding/skills/make-changelog
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add gupsammy/Claudest --skill make-changelog -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/gupsammy/Claudest --path plugins/claude-coding/skills/make-changelog
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/make-changelog/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/gupsammy/Claudest/tree/HEAD/plugins/claude-coding/skills/make-changelog/SKILL.md

## When to use it
- create `CHANGELOG.md` from commit history
- add releases missing since the last recorded version
- refresh the `[Unreleased]` section
- sort changes into Keep a Changelog categories

## Example prompts
- Create `CHANGELOG.md` from the Git history and organize the entries using Keep a Changelog.
- Add the releases missing since the latest version already in my changelog.
- Refresh only `[Unreleased]` using the recent commits.

## Similar
- [make-documentation](https://affpapa.org/en/nevibecode/skills/make-documentation.md) — skill · 1500 installs
- [make-pdf](https://affpapa.org/en/nevibecode/skills/make-pdf.md) — skill · 353 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/claude-office-skills-changelog-generator.md) — skill · 4800 installs
- [om-auto-update-changelog](https://affpapa.org/en/nevibecode/skills/om-auto-update-changelog.md) — skill · 4100 installs

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