breaking-change-detector

Detect and block breaking API, schema, and interface changes during code reviews.

3|2|Updated Mar 23, 2026
One-click install
npx skills add https://github.com/wesleyegberto/software-engineering-skills --skill breaking-change-detector-wesleyegberto
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: breaking-change-detector
Source: https://github.com/wesleyegberto/software-engineering-skills/tree/main/plugins/programming-skills/skills/breaking-change-detector
Command: npx skills add https://github.com/wesleyegberto/software-engineering-skills --skill breaking-change-detector-wesleyegberto

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Detects and warns about breaking API, schema, and interface changes before they are implemented, acting as a gatekeeper to enforce safe evolution.

Core Features & Use Cases

  • Automatic detection and classification of breaking changes across API endpoints, database schemas, and interface contracts.
  • Enforce deprecation, versioning, and migration policies aligned with api-strategy.md.
  • Guidance for safe migrations and blocking changes when no migration plan exists.

Quick Start

Follow the prompts to evaluate a proposed change and let the system auto-detect, classify, assess impact, and propose safe migrations.

Frequently Asked Questions about breaking-change-detector

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

FAQPage Schema
How do I detect breaking API changes before implementation?

Detect breaking API changes by applying automated detection during code reviews to classify modifications across endpoints, schemas, and contracts before implementation begins. This ensures unsafe changes are blocked early.

What is a breaking change in database schemas and API contracts?

A breaking change in database schemas and API contracts is any modification that disrupts existing consumers. The system automatically detects, classifies, and assesses the impact of these changes to enforce safe evolution.

How do I enforce API versioning and deprecation policies during code review?

Enforce API versioning and deprecation policies by evaluating proposed changes through automated checks aligned with api-strategy.md. The system blocks changes when no migration plan exists and provides guidance for safe transitions.

Can I assess the impact of interface contract changes automatically?

You can assess the impact of interface contract changes automatically by running the detector during PRs. It evaluates proposed modifications against versioning policies to determine risk and generate migration guidance.

How do I generate migration guidance for deprecated API endpoints?

Generate migration guidance for deprecated API endpoints by letting the system evaluate your proposed changes. It aligns with api-strategy.md to propose safe migrations and blocks changes lacking a proper migration plan.