Skip to content
Back to skills

Breaking Changes

ASecurity

Detect breaking changes in Claude Code updates by comparing current API surface against changelog. Maps impacts to specific plugin files.

  • 29 stars
  • 0 votes
  • 0 copies
  • 0 views
  • Added May 28, 2026
ai-agentsapi

Works with

  • claude code
  • cli
  • api

Security analysis

A100/100

Pro scans all 3 files and shows the line behind each finding

Scanned May 28, 2026

npx -y skills add fusengine/agents --skill breaking-changes --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Breaking Changes?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Breaking Changes
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/fusengine-breaking-changes/badge)](https://www.skillsdirectory.com/skills/fusengine-breaking-changes)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: breaking-changes
description: Detect breaking changes in Claude Code updates by comparing current API surface against changelog. Maps impacts to specific plugin files.
argument-hint: "[version]"
user-invocable: true
---

# 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 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

- [API Surface](references/api-surface.md)
- [Migration Guide Template](references/templates/migration-guide.md)

Files in this skill

  • SKILL.md1.3 KB
  • references/api-surface.md7.2 KB
  • references/templates/migration-guide.md1 KB

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

Comments

Loading comments…