Upgrade Breaking Change Navigator
Plan and execute risky Spring Boot, Spring Framework, Kotlin, Gradle, JDK, and major dependency upgrades with explicit compatibility checkpoints and rollback thinking. Use when preparing or diagnosing a major version jump, navigating `javax` to `jakarta`, K2 adoption, plugin compatibility, auto-configuration drift, behavior changes in Hibernate or Security, or project-specific upgrade sequencing.
Install
npx skills add JetBrains/skills --skill upgrade-breaking-change-navigatorgit clone --depth 1 https://github.com/JetBrains/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/upgrade-breaking-change-navigator ~/.claude/skills/upgrade-breaking-change-navigatorPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Upgrade Breaking Change Navigator Source mapping: Tier 3 specialized skill derived from `Kotlin_Spring_Developer_Pipeline.md` (`SK-22`). ## Mission Turn a risky platform upgrade into a controlled sequence of small, verifiable moves. Optimize for incremental confidence, not for a single giant leap that hides the source of breakage. ## Read First - Current Gradle wrapper, Kotlin plugin, Spring Boot plugin, JDK, and key dependency versions. - Version catalogs, convention plugins, and BOM ownership. - Build failures, test failures, runtime startup failures, and deprecation reports. - The actual libraries and features in use: Security, Data JPA, WebFlux, AOT/native, messaging, serialization, cloud config. - Official upgrade notes when available. ## Upgrade Strategy 1. Identify the target version and the last known good current version. 2. Identify mandatory intermediate steps. Do not skip major lines casually. 3. Separate upgrade layers: - JDK - Gradle wrapper - Kotlin plugin and compiler - Spring Boot and Spring Framework - ecosystem libraries 4. Upgrade one authority at a time whenever possible. 5. After each step, verify: - dependency resolution - compile - tests - startup smoke 6. Record breakages by layer so the root cause stays attributable. ## Advanced Upgrade Hotspots - `javax.*` to `jakarta.*` is both source migration and dependency compatibility migration.
Details
- Skill name
upgrade-breaking-change-navigator- Repository
- JetBrains/skills
- Path
upgrade-breaking-change-navigator/SKILL.md- Repo updated
- 21 October 2026
FAQ
What does the Upgrade Breaking Change Navigator skill do?
Plan and execute risky Spring Boot, Spring Framework, Kotlin, Gradle, JDK, and major dependency upgrades with explicit compatibility checkpoints and rollback thinking. Use when preparing or diagnosing a major version jump, navigating `javax` to `jakarta`, K2 adoption, plugin compatibility, auto-configuration drift, behavior changes in Hibernate or Security, or project-specific upgrade sequencing.
How do I install the Upgrade Breaking Change Navigator skill?
skills CLI (Claude Code, Cursor, Codex and more): npx skills add JetBrains/skills --skill upgrade-breaking-change-navigator. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Upgrade Breaking Change Navigator popular?
It lives in JetBrains/skills, which has 398 GitHub stars and 35 forks.
Related skills
Deploy to Vercel
398JetBrains/skills
Deploy applications and websites to Vercel. Use when the user requests deployment actions like "deploy my app", "deploy and give me the link", "push this live", or "create a preview deployment".
Vercel React Native Skills
398JetBrains/skills
React Native and Expo best practices for building performant mobile apps. Use when building React Native components, optimizing list performance, implementing animations, or working with native modules. Triggers on tasks involving React Native, Expo, mobile performance, or native platform APIs.
Vitest
398JetBrains/skills
Vitest fast unit testing framework powered by Vite with Jest-compatible API. Use when writing tests, mocking, configuring coverage, or working with test filtering and fixtures.
Dep Lib Review
423mizchi/skills
Periodic dependency review for Node.js/pnpm projects — outdated package triage, security audit, update batching strategy (patch/minor/major), validation checklist. Run monthly or before major releases. Use when asked to review or update dependencies in a repo.
Spring Security Configurator Auditor
398JetBrains/skills
Design and audit Spring Security configurations for Kotlin plus Spring services, including filter chains, JWT or OAuth2 resource server setup, method security, CORS, CSRF rationale, and public endpoint exposure. Use when adding or reviewing authentication and authorization, narrowing access rules, validating token handling, or checking for insecure defaults and accidental exposure.
Frontend Review Security
423mizchi/skills
Use when conducting a frontend security review — static analysis (risky HTML patterns, env var exposure), authentication/authorization audit (token storage, route guards, logout), and AI self-penetration testing. Runs `scripts/audit-security.sh`. For CVE triage and deprecated library detection, use `frontend-review-deps`.
Browse the most popular Claude skills, all security skills, or write your own with the skills generator.