find-breaking-rest-api

Analyze git history to detect breaking changes in REST API endpoints and schemas.

7|Updated Mar 13, 2026
One-click install
npx skills add https://github.com/dan323/easier-life-skills --skill find-breaking-rest-api
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: find-breaking-rest-api
Source: https://github.com/dan323/easier-life-skills/tree/main/plugins/find-breaking-rest-api/skills/find-breaking-rest-api
Command: npx skills add https://github.com/dan323/easier-life-skills --skill find-breaking-rest-api

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires git, bash, grep, diff, schema extraction tools, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill enables teams to automatically identify breaking changes introduced in REST APIs during code updates, preventing accidental disruptions for clients.

Core Features & Use Cases

  • API Compatibility Analysis: Compares API surface between two git revisions to find incompatible changes.
  • Multi-Platform Support: Works with popular frameworks like Flask, FastAPI, Express, Spring Boot, and OpenAPI/Swagger specifications.
  • Use Case: When refactoring endpoints or updating API versions, developers can run this Skill to ensure no breaking changes are unintentionally introduced, saving time and avoiding client-side failures.

Quick Start

Ask the AI to analyze the latest git revision against the previous tag to identify any potential breaking REST API changes in your project.

Frequently Asked Questions about find-breaking-rest-api

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect breaking changes in a REST API across git revisions?

To detect breaking changes in a REST API across git revisions, compare API endpoints, request and response schemas, and authentication settings between code versions to ensure backward compatibility and stable integrations.

Can I check REST API compatibility with OpenAPI or Swagger specifications?

Yes, you can check REST API compatibility using OpenAPI or Swagger specifications, as well as popular frameworks like Flask, FastAPI, Express, and Spring Boot, to identify incompatible schema changes between revisions.

How do I prevent accidental disruptions to clients when refactoring API endpoints?

To prevent accidental disruptions to clients when refactoring API endpoints, analyze your git history to automatically identify breaking REST API changes before deployment, ensuring stable integrations and avoiding client-side failures.

Do I need git and bash to compare API schemas between code versions?

Yes, you need git, bash, grep, diff, and schema extraction tools to compare API schemas between code versions, as these dependencies are required to analyze revisions and extract the API surface for compatibility analysis.

What is the best way to find incompatible REST API updates during code refactoring?

The best way to find incompatible REST API updates during code refactoring is to compare the API surface between two git revisions, automatically detecting changes to endpoints and schemas that break backward compatibility.

Why does my REST API integration break after updating code revisions?

Your REST API integration breaks after updating code revisions because incompatible changes were likely introduced to API endpoints, request or response schemas, or authentication settings, disrupting backward compatibility for existing clients.