What files does it analyze in my project?

It scans plugin manifests, agent frontmatter, hook implementations, and script CLI flags to ensure all components of your agent system remain functional.

How does the Breaking Changes Detector identify issues?

The skill compares your project's api-surface.md reference against the latest Claude Code documentation, then greps your local codebase to find where those specific APIs are used.

What kind of changes can it detect?

It detects removed APIs, renamed schema fields, new mandatory parameters, deprecated hooks, and newly available optional APIs.

Can this skill fix the breaking changes automatically?

It currently focuses on detection and reporting with file:line mapping; however, you can use the resulting report to direct Claude to apply specific migrations.

Do I need to manually provide the version to check?

While the skill can fetch the latest updates, it also supports an optional version argument to check compatibility against specific Claude Code releases.

Breaking Changes Detector

Name: Breaking Changes Detector
Author: fusengine

byfusengine

•

安全与测试

Identifies compatibility risks in Claude Code updates by mapping API surface changes directly to your plugin source code.

The Breaking Changes Detector skill automates the critical task of monitoring Claude Code API updates to prevent system regressions. By analyzing the delta between your current API surface and the latest official changelogs, the skill performs an intelligent scan of your entire plugin ecosystem. It doesn't just list changes; it maps impacts to specific file paths and line numbers, categorizing risks by severity—from deprecated hooks to critical breaking schema changes—allowing developers to maintain robust agent systems with minimal manual oversight.

主要功能

014 GitHub stars

02Automated diffing between current API surface and latest Claude Code documentation

03Version-specific analysis via user-invocable argument hints

04Deep-grep impact mapping to identify specific file and line compatibility issues

05Support for scanning hook types, agent frontmatter, and plugin manifest schemas

06Severity-based reporting for breaking, deprecated, and new API features

使用场景

01Maintaining large-scale agent ecosystems by identifying deprecated API patterns

02Auditing local plugin compatibility before performing Claude Code environment upgrades

03Generating automated migration checklists based on detected breaking changes

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add fusengine/agents breaking-changes

For use in Claude.ai and ChatGPT

Download Skill