breaking-changes

Installation
SKILL.md

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

Related skills
Installs
22
GitHub Stars
11
First Seen
Feb 28, 2026