# OpenAPI Diff

> Use this tool when you need to compare and analyze differences between OpenAPI specifications, identifying breaking changes and compatibility issues. It accepts two OpenAPI specs as input and generates detailed difference reports in various formats, including Markdown, JSON, and plain text. Ideal for versioning workflows, CI/CD pipeline integration, and backward compatibility validation in API development and maintenance.

Canonical page: https://skillsregistry.net/skills/lordofthejars-openapi-diff  
JSON: https://api.skillsregistry.net/v1/skills/lordofthejars-openapi-diff

## Description

Provides automated comparison and compatibility analysis between OpenAPI specifications. Accepts two OpenAPI specs (as raw content or URLs) and generates detailed difference reports in multiple formats including Markdown, AsciiDoc, JSON, and plain text. Identifies breaking changes, compatibility issues, and structural differences between API versions. Built with Quarkus and leveraging the OpenAPITools openapi-diff-core library for versioning workflows, CI/CD pipeline integration, and backward compatibility validation.

## Trust

- **Trust score (0–1):** 1.00
- **Verification tier:** verified
- **Last scanned:** 2026-09-19

## Facts

- **Version:** 1.0.0
- **Skill type:** atomic
- **Execution layer:** mcp-remote
- **Runtime environment:** api
- **Category:** devops-ci
- **Updated:** 2026-09-19

## Source

- **Source listing:** [PulseMCP](https://www.pulsemcp.com/servers/lordofthejars-openapi-diff)
- **Repository:** <https://github.com/lordofthejars/openapi-diff-mcp-server>

## Use it

Resolve this record through the SkillsRegistry MCP server (no auth, read-only):

```
claude mcp add --transport http --scope user skillsregistry https://api.skillsregistry.net/mcp
```

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_skill",
    "arguments": {
      "slug": "lordofthejars-openapi-diff"
    }
  }
}
```

REST: `GET https://api.skillsregistry.net/v1/skills/lordofthejars-openapi-diff` · pull for local use: `GET https://api.skillsregistry.net/v1/skills/lordofthejars-openapi-diff/pull`

---
SkillsRegistry indexes agent skills from public registries and GitHub. Skills we have analysed are scanned with Circle-IR and scored on six dimensions; each listing states its scan coverage. More: https://skillsregistry.net/llms.txt