breaking-change-detector

Identify breaking changes in public APIs, function signatures, endpoints, and data schemas.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/MacroMan5/claude-code-workflow-plugins --skill breaking-change-detector-macroman5
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: breaking-change-detector
Source: https://github.com/MacroMan5/claude-code-workflow-plugins/tree/main/.claude/skills/breaking-change-detector
Command: npx skills add https://github.com/MacroMan5/claude-code-workflow-plugins --skill breaking-change-detector-macroman5

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Detects backward-incompatible changes to public APIs, function signatures, endpoints, and data schemas before they break production. Suggests migration paths.

Core Features & Use Cases

  • Change detection: Recognizes breaking vs. safe changes.
  • Migration guidance: Proposes migration paths for breaking changes.
  • Use Case: When refactoring APIs, determine if changes are breaking before deployment.

Quick Start

Describe proposed changes to an API; ask for breaking-change analysis.

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 changes in my API before deployment?

Breaking change detection identifies backward-incompatible modifications to public APIs, function signatures, and endpoints by comparing versions and flagging removals, renames, and format changes. Run analysis on proposed changes before deployment to prevent production failures and customer impact.

What counts as a breaking change in API versioning?

Breaking changes include removal or renaming of parameters and methods, alterations to response formats, endpoint modifications, and schema changes. The detector recognizes these as incompatible with existing client code and flags them for migration planning.

Can I get migration guidance when I find breaking changes?

Yes, the breaking change detector outputs structured assessments with suggested migration paths for each incompatible change, helping you plan transition strategies and communicate upgrades to users before deployment.

How do I use breaking change detection during API refactoring?

Describe your proposed API modifications—parameter changes, endpoint restructuring, or schema updates—and request breaking change analysis. The detector identifies which changes break compatibility and recommends migration approaches.

Does breaking change detection work with data schema migrations?

Yes, the detector covers schema migrations alongside API and function signature changes, identifying incompatibilities in data structure modifications that would impact downstream systems and clients.