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.