breaking-changes

SkillAI & models

Use when checking whether a Claude Code update breaks our plugin ecosystem — hooks, agent frontmatter, manifest schema, or skill format.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the breaking-changes skill

What this skill tells your AI

The instructions your AI receives, as published by fusengine/agents in plugins/changelog-watcher/skills/breaking-changes/SKILL.md and read by ahel’s review.

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 TypeSeverityExample
Removed APIBREAKINGHook type deleted
Changed schemaBREAKINGFrontmatter field renamed
New required fieldBREAKINGMandatory new param
Deprecated APIDEPRECATEDOld hook still works
New optional APINEWNew hook type added

References

Signals

GitHub stars
25
Forks
4
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
breaking-changes
Source
github.com/fusengine/agents