Can this skill help with Semantic Versioning (SemVer)?

Yes, by identifying if any breaking changes exist, the skill helps you determine if your update requires a major version bump versus a minor or patch release.

What types of changes are considered 'breaking'?

Breaking changes include removed endpoints, renamed required parameters, changed response status codes, narrowed validation rules (like enum removals), and modified authentication requirements.

How does the skill handle very large API specifications?

The skill uses pagination for large diffs and allows you to filter for 'breaking changes only' to prioritize the most critical updates before reviewing minor changes.

Can I compare two completely different APIs with this skill?

This tool is optimized for comparing versions of the same API. Comparing unrelated APIs will produce a large volume of non-meaningful differences; for that use case, it is better to explore each API individually.

OpenAPI Spec Diff & Migration

Name: OpenAPI Spec Diff & Migration
Author: erraggy

byerraggy

•

API開発

Compares OpenAPI specification versions to identify breaking changes and generate detailed migration guides for API consumers.

This skill enables Claude to perform deep comparisons between different versions of an OpenAPI specification, automatically identifying critical breaking changes, deprecations, and new features. It provides structured insights by categorizing changes by severity (Breaking, Warning, Informational), explaining the specific impact of modifications on client-side integrations, and suggesting actionable migration steps. It is an essential tool for developers managing API lifecycles, ensuring backward compatibility, and maintaining accurate documentation during version transitions.

主な機能

012 GitHub stars

02Automated detection of breaking changes in OpenAPI and Swagger files

03Actionable migration guidance for every identified breaking change

04Categorized change reporting by severity: Breaking, Warning, and Informational

05Paginated diffing support for handling large enterprise API specifications

06Detailed impact analysis for paths, parameters, and response schemas

ユースケース

01Generating automated migration checklists and release notes for API version bumps

02Validating that a new API version correctly follows semantic versioning (SemVer) rules

03Identifying potential breakages in client integrations when upgrading a third-party API

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add erraggy/oastools diff-specs

For use in Claude.ai and ChatGPT