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
- 01Diffs Claude Code API against a reference surface
- 02Checks plugins for changed APIs
- 03Maps impacts to file and line
- 04Classifies changes by severity
Use cases
- 01Check plugin compatibility after Claude Code updates
- 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-changesAfter 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
- Load current api-surface.md
- Fetch latest Claude Code API docs
- Diff for added/changed/removed APIs
- Grep our plugins for each changed API
- Report with file:line impact mapping
Impact Assessment
| Change Type | Severity | Example |
|---|---|---|
| Removed API | BREAKING | Hook type deleted |
| Changed schema | BREAKING | Frontmatter field renamed |
| New required field | BREAKING | Mandatory new param |
| Deprecated API | DEPRECATED | Old hook still works |
| New optional API | NEW | New hook type added |
References
Comments
Markdown supported