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
- 01Track Claude Code API surfaces
- 02Compare APIs with official updates
- 03Search plugins for affected APIs
- 04Report file and line impacts
- 05Classify changes by severity
Use cases
- 01Check plugins after a Claude Code update
- 02Locate uses of removed or changed APIs
- 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-changesAfter 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
- 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