skills.rest
fusengine
fusengineCOMMUNITY
Explore all skills by this author →
Website𝕏@fusengineGitHub

breaking-changes

Compare Claude Code API surfaces against changelogs to detect breaking changes.

22|3|Updated Jan 10, 2026
Search Tags:#changelog#versioning#api#compatibility#code maintenance#plugin development
One-click install
npx skills add https://github.com/fusengine/agents --skill breaking-changes
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: breaking-changes
Source: https://github.com/fusengine/agents/tree/main/plugins/changelog-watcher/skills/breaking-changes
Command: npx skills add https://github.com/fusengine/agents --skill breaking-changes

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill automatically identifies compatibility issues between your plugins and new Claude Code versions by comparing API surface changes, preventing unexpected breakages.

Core Features & Use Cases

  • API Surface Monitoring: Tracks changes in Claude Code hooks, schemas, and CLI flags.
  • Impact Analysis: Maps API changes directly to affected plugin files and lines of code.
  • Use Case: Before updating Claude Code, run this skill to get a report detailing exactly which of your plugins might break and where to fix them.

Quick Start

Run the breaking-changes skill to check for compatibility issues with the latest Claude Code version.

Frequently Asked Questions about breaking-changes

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect breaking changes in Claude Code API updates?▼

Detect breaking changes by fetching the latest Claude Code API documentation and diffing it against a local api-surface.md reference file. This process maps impacts to specific plugin files and provides severity assessments for API modifications.

What is API surface monitoring for plugin compatibility?▼

API surface monitoring tracks changes in Claude Code hooks, schemas, and CLI flags to identify compatibility issues. It compares API surface changes against changelog information to prevent unexpected plugin breakages before updating.

How do I check if a Claude Code update will break my plugins?▼

Check if a Claude Code update will break your plugins by running a compatibility check before updating. This generates a report detailing exactly which plugins might break and maps API changes directly to affected plugin files and lines of code.

Do I need a local api-surface.md file to analyze API compatibility?▼

Yes, you need a local api-surface.md reference file to analyze API compatibility. The detection process requires fetching the latest Claude Code API documentation and diffing it against this local reference to identify breaking changes accurately.

What is the best way to map API modifications to specific plugin files?▼

The best way to map API modifications to specific plugin files is to perform an impact analysis. This compares API surface changes against changelog information and maps API changes directly to affected plugin files and lines of code.

Related Skills

Explore More Software Engineering Skills→
johnendjohnend
23

audit-claude-setup

Compare Claude Code configuration against official documentation and generate a remediation plan.

Community
Advanced
majiayu000majiayu000
12

skill

Route user requests to registered skill modules and execute them in context.

Community
Basic
OshanKHZOshanKHZ
5

hook-development

Create and implement Claude Code plugin hooks for lifecycle events.

Community
Advanced
snhrmsnhrm

library-release-checker

Identify breaking changes and deprecations from library release notes.

Community
Advanced