Breaking Changes Skill: Semver-Ready Change Summary
Diffs public exports, handlers, and schema between two refs and labels by semver impact. Most accidental breaks ship because nobody ran the diff against the public surface specifically.
Full Prompt
An installable breaking-changes skill. Diffs public exports, HTTP/RPC handlers, and DB schema between two refs and labels each change by semver impact.
What It Does
- Public-surface diff — exports, handlers, GraphQL, schema, CLI
- Semver labels — major, minor, patch per finding
- Soft-deprecate path — suggests the bridge before recommending a break
- Default to major when unsure — false-positive is recoverable
Install in 30 Seconds
Pick your tool above and download:
- Claude Code:
~/.claude/skills/breaking-changes/SKILL.md - OpenAI Codex CLI: append to
AGENTS.md - Cursor: append to
.cursorrules
Same content, three install paths. Reload and ask for the audit on your next change.
Why This Skill Earns Its Keep
Most accidental breaks ship because nobody ran the diff against the public surface specifically. This skill draws that line: it knows which surfaces are public, and it defaults to the safer label when the call is close. That's how you avoid a 2-line patch causing a 1.0 → 2.0 bump.
Install once, run before every push.