mcpField
B
breaking-changes

breaking-changes

github.com/fusengineDevelopment3440 installsUpdated 2w ago
Repository

About breaking-changes

A skill for checking Claude Code updates for compatibility risks across plugin APIs. It compares a tracked API surface with official changes and maps affected plugin locations by severity.

Key features

  1. 01Track Claude Code API surfaces
  2. 02Compare APIs with official updates
  3. 03Search plugins for affected APIs
  4. 04Report file and line impacts
  5. 05Classify changes by severity

Use cases

  1. 01Check plugins after a Claude Code update
  2. 02Locate uses of removed or changed APIs
  3. 03Review deprecated and newly added APIs

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/fusengine/claude-plugins --skill breaking-changes

After installing, type/breaking-changesin Claude Code to confirm it loaded.

Details

From the project README
Detects breaking changes in Claude Code updates by diffing the current API surface (hook types and matchers, agent frontmatter fields, plugin manifest schema, SKILL.md format, script CLI flags — tracked in `references/api-surface.md`) against the official changelog. Greps our plugins for each changed API and reports impact mapped to specific file:line locations, classified by severity (BREAKING / DEPRECATED / NEW).

Breaking Changes Detection Skill

Overview

Compares Claude Code API changes against our plugin ecosystem to detect compatibility issues.

API Surface File

The api-surface.md reference contains our current known API:

  • Hook types and their matchers
  • Agent frontmatter fields
  • Plugin manifest schema
  • Skill SKILL.md format
  • Script CLI flags used

Detection Workflow

  1. Load current api-surface.md
  2. Fetch latest Claude Code API docs
  3. Diff for added/changed/removed APIs
  4. Grep our plugins for each changed API
  5. Report with file:line impact mapping

Impact Assessment

Change TypeSeverityExample
Removed APIBREAKINGHook type deleted
Changed schemaBREAKINGFrontmatter field renamed
New required fieldBREAKINGMandatory new param
Deprecated APIDEPRECATEDOld hook still works
New optional APINEWNew hook type added

References

Comments

Markdown supported