---
title: "OpenAPI Spec Changelog Generator"
description: "Compares OpenAPI 3.x specification files using the oasdiff library to detect breaking changes, deprecated endpoints, and schema modifications. Outputs structured changelogs in Markdown or JSON."
verification: "security_reviewed"
source: "https://github.com/oasdiff/oasdiff"
author: "oasdiff"
category:
  - "Library & API Reference"
framework:
  - "Cursor"
tool_ecosystem:
  github_repo: "oasdiff/oasdiff"
  github_stars: 1184
---

# OpenAPI Spec Changelog Generator

Compares OpenAPI 3.x specification files using the oasdiff library to detect breaking changes, deprecated endpoints, and schema modifications. Outputs structured changelogs in Markdown or JSON.

## Installation

Choose whichever fits your setup:

1. Copy this skill folder into your local skills directory.
2. Clone the repo and symlink or copy the skill into your agent workspace.
3. Add the repo as a git submodule if you manage shared skills centrally.
4. Install it through your internal provisioning or packaging workflow.
5. Download the folder directly from GitHub and place it in your skills collection.

Install command or upstream instructions:

```
go install github.com/oasdiff/oasdiff@latest
```

## Documentation

- https://www.oasdiff.com/

## Source

- [Agent Skill Exchange](https://agentskillexchange.com/skills/openapi-spec-changelog-generator/)