mcpField
B
breaking-changes

breaking-changes

github.com/fusengineTesting & quality3440 installsUpdated 2w ago
Repository

About breaking-changes

breaking-changes is a skill for maintainers of Claude Code plugins. It compares documented API changes with plugin usage and reports affected locations by severity.

Key features

  1. 01Diffs Claude Code API against a reference surface
  2. 02Checks plugins for changed APIs
  3. 03Maps impacts to file and line
  4. 04Classifies changes by severity

Use cases

  1. 01Check plugin compatibility after Claude Code updates
  2. 02Locate code affected by a removed or changed API

Install

Copy the command and run it in a terminal.

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

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

Bundled filesreferences/api-surface.mdreferences/templates/migration-guide.md

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