breaking-changes
starsforks
How to install breaking-changes?
fusengine/agents/breaking-changes
$npx -y skills add fusengine/agents --skill breaking-changesDetect breaking changes in Claude Code updates by comparing current API surface against changelog. Maps impacts to specific plugin files. Use when: checking whether a Claude Code update breaks our plugin ecosystem (hooks, agent frontmatter, manifest schema, or skill format).
SKILL.md
| 1 | # Breaking Changes Detection Skill |
| 2 | |
| 3 | ## Overview |
| 4 | |
| 5 | Compares Claude Code API changes against our plugin ecosystem to detect compatibility issues. |
| 6 | |
| 7 | ## API Surface File |
| 8 | |
| 9 | The `api-surface.md` reference contains our current known API: |
| 10 | - Hook types and their matchers |
| 11 | - Agent frontmatter fields |
| 12 | - Plugin manifest schema |
| 13 | - Skill SKILL.md format |
| 14 | - Script CLI flags used |
| 15 | |
| 16 | ## Detection Workflow |
| 17 | |
| 18 | 1. **Load** current api-surface.md |
| 19 | 2. **Fetch** latest Claude Code API docs |
| 20 | 3. **Diff** for added/changed/removed APIs |
| 21 | 4. **Grep** our plugins for each changed API |
| 22 | 5. **Report** with file:line impact mapping |
| 23 | |
| 24 | ## Impact Assessment |
| 25 | |
| 26 | | Change Type | Severity | Example | |
| 27 | |-------------|----------|---------| |
| 28 | | Removed API | BREAKING | Hook type deleted | |
| 29 | | Changed schema | BREAKING | Frontmatter field renamed | |
| 30 | | New required field | BREAKING | Mandatory new param | |
| 31 | | Deprecated API | DEPRECATED | Old hook still works | |
| 32 | | New optional API | NEW | New hook type added | |
| 33 | |
| 34 | ## References |
| 35 | |
| 36 | - [API Surface](references/api-surface.md) |
| 37 | - [Migration Guide Template](references/templates/migration-guide.md) |
People who liked this also viewed
6 picksType
- find-skillsHelps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skSkillsJul 2026
- grill-meA relentless interview to sharpen a plan or design.SkillsJul 2026
- vercel-react-best-practicesVercel's official collection of agent skillsSkillsJul 2026
- improve-codebase-architectureScan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.SkillsJul 2026
- setup-matt-pocock-skillsConfigure this repo for the engineering skills — set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use of the other engineering skills.SkillsJul 2026
- triageMove issues and external PRs through a state machine of triage roles — categorise, verify, grill if needed, and write agent-ready briefs.SkillsJul 2026
