# API changelog (/docs--api-changelog)

/docs--api-changelog is a Claude Code skill in the Code section. Compares two versions of your API, classifies changes as breaking, non-breaking or deprecations, and writes migration notes.

- Web version: https://skills.sgomez.dev/en/s/docs--api-changelog
- Section: [Code](https://skills.sgomez.dev/en/code.md)
- Author: Santiago Gómez de la Torre
- License: MIT
- Source: https://github.com/sgomez-dev/claude-skills/blob/main/skills/docs/api-changelog.md
- Updated 10 Jul 2026

## How to ask for it

- `/docs--api-changelog compare v1 and v2 of my API and flag breaking changes`
- `/docs--api-changelog generate the changelog for this release with migration notes`
- `/docs--api-changelog which endpoints changed since the last version`

## Install

macOS · Linux:

```
curl -fsSL https://raw.githubusercontent.com/sgomez-dev/claude-skills/main/install.sh | bash
```

Windows:

```
irm https://raw.githubusercontent.com/sgomez-dev/claude-skills/main/install.ps1 | iex
```

Claude Code plugin:

```
/plugin marketplace add sgomez-dev/claude-skills
/plugin install docs-skills@claude-skills-collection
```

## Permissions

- Reads: `**/*`, `.git/**`
- Writes: `API_CHANGELOG.md`, `docs/api-changelog.md`
- Runs: `git diff`, `git log`, `git show`, `git tag`
- Network: No
- Destructive: No

## Author's description

API changelog - detect breaking changes between versions with migration notes

- [How we review this](https://skills.sgomez.dev/en/methodology.md)