breaking-change-detector

Detect breaking API, schema, and interface changes before production.

Updated Feb 14, 2026
One-click install
npx skills add https://github.com/DYAI2025/MOD_shark-engine --skill breaking-change-detector-dyai2025
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: breaking-change-detector
Source: https://github.com/DYAI2025/MOD_shark-engine/tree/main/sharkengine/.claude/skills/breaking-change-detector
Command: npx skills add https://github.com/DYAI2025/MOD_shark-engine --skill breaking-change-detector-dyai2025

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Detect and warn about breaking API/schema changes before implementation. Auto-trigger when modifying API routes, database schemas, or public interfaces. Validates changes against api-strategy.md versioning rules. Suggests migration paths for breaking changes. Prevents removing endpoints, changing request/response formats, dropping database columns, modifying function signatures without deprecation.

Core Features & Use Cases

  • Detects API endpoint removals, schema changes, and interface modifications across codebases.
  • Classifies changes by severity and recommends safe migration strategies.
  • Blocks deployment of critical changes until a migration plan is approved and versioning requirements are satisfied.

Quick Start

On planning a change, run the detector to identify breaking changes and generate migration options.

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 deployment?

Detect breaking API changes by analyzing endpoint modifications, schema alterations, and interface updates against versioning rules to classify severity and block deployment without an approved migration plan.

What is a breaking change in database schema and public interfaces?

A breaking change in database schema and public interfaces includes dropping columns, removing endpoints, or modifying function signatures without deprecation, which disrupts existing client integrations.

How do I generate a migration strategy for API versioning modifications?

Generate a migration strategy for API versioning modifications by analyzing usage and impact, classifying severity, and suggesting safe migration paths to satisfy safety requirements before changes reach production.

Can I block critical code changes until a migration plan is approved?

Yes, you can block critical code changes by validating modifications against versioning rules and preventing the deployment of endpoint removals or signature changes until a migration plan is approved.

Does the breaking change detector work with database schema changes and API routes?

Yes, the breaking change detector works with database schema changes and API routes by automatically triggering on modifications to analyze impact, classify severity, and recommend safe migration strategies.