Does it identify new features that are safe to deploy?

Yes, the tool explicitly categorizes non-breaking changes such as new paths, added schemas, or new optional properties.

How does this enhance the Claude Code experience?

It provides Claude with the specialized logic needed to audit your API design work, ensuring that your AI-generated code maintains contract stability.

What types of API specifications does this skill support?

It is designed to analyze standard API documentation files, such as OpenAPI and Swagger, to detect structural changes between versions.

What is considered a breaking change by this tool?

The skill flags actions like removing endpoints, deleting HTTP methods, changing data types, or making previously optional properties required.

Can this skill be used in a CI/CD pipeline?

Yes, the command-line interface allows it to be integrated into automation scripts to prevent merging breaking API changes.

API Compatibility Checker

Name: API Compatibility Checker
Author: epieczko

byepieczko

0•

API 개발

Compares API specifications to detect breaking changes and ensure backward compatibility between versions.

The API Compatibility skill enables developers to automatically identify regressions and breaking changes within their API contracts. By comparing old and new versions of API specifications, such as OpenAPI or Swagger files, it flags critical issues like removed endpoints, modified property types, or newly required fields that could disrupt existing integrations. This tool is essential for teams maintaining robust backend services, ensuring that version updates do not inadvertently break the experience for API consumers.

주요 기능

01Flags property type changes and newly mandatory field constraints

02Supports human-readable output formats for manual review

03Identifies removed endpoints, HTTP methods, and model schemas

04Highlights non-breaking enhancements like new optional fields

050 GitHub stars

06Automated detection of breaking changes in API specifications

사용 사례

01Validating API schema updates before deploying new backend versions

02Auditing changes between legacy and modern API documentation versions

03Ensuring backward compatibility in CI/CD pipelines during code reviews

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add epieczko/betty api.compatibility

For use in Claude.ai and ChatGPT

Download Skill