Covers the full upgrade path from Java 8 through 25, hitting each LTS release with the breaking changes that actually matter. Shows you exactly what APIs got removed (JAXB, Security Manager, Unsafe methods), what dependencies to add, and which JVM flags to throw at module system complaints. The migration workflow is sensible: assess, update build config, fix compilation, test, check runtime warnings. Really shines on the feature adoption sections, like showing you when to switch from ThreadLocal to ScopedValues or how virtual threads change concurrency in Java 21. The quick reference tables are clutch when you just need to know what breaks between versions without reading Oracle's release notes.

skills.sh installs
357
GitHub stars
771
last updated
Feb 8, 2026

Install

$ npx -y skills add decebals/claude-code-java --skill java-migration --agent claude-code

Installs into .claude/skills of the current project.

Files

Java Migration Skill

Step-by-step guide for upgrading Java projects between major versions.

When to Use

  • User says "upgrade to Java 25" / "migrate from Java 8" / "update Java version"
  • Modernizing legacy projects
  • Spring Boot 2.x → 3.x → 4.x migration
  • Preparing for LTS version adoption

Migration Paths

Java 8 (LTS) → Java 11 (LTS) → Java 17 (LTS) → Java 21 (LTS) → Java 25 (LTS)
     │              │               │              │               │
     └──────────────┴───────────────┴──────────────┴───────────────┘
                         Always migrate LTS → LTS

Quick Reference: What Breaks

From → ToMajor Breaking Changes
8 → 11Removed javax.xml.bind, module system, internal APIs
11 → 17Sealed classes (preview→final), strong encapsulation
17 → 21Pattern matching changes, finalize() deprecated for removal
21 → 25Security Manager removed, Unsafe methods removed, 32-bit dropped

Migration Workflow

Step 1: Assess Current State

# Check current Java version
java -version

# Check compiler target in Maven
grep -r "maven.compiler" pom.xml

Sponsors

Details

Repository
github.com/decebals/claude-code-java
Categories
Documentation, Release Management, Java & JVM
License
MIT
First seen
Jun 11, 2026

More from decebals/claude-code-java

All 18
1pproenca avatarios-animationspproenca/dot-skillsClinic-architecture-aligned iOS animation craft guidelines for SwiftUI (iOS 26 / Swift 6.2) covering motion tokens, spring physics, gesture continuity, spatial 355skills.sh installs
2jezweb avatarskill-reviewjezweb/claude-skillsAudit claude-skills with systematic 9-phase review: standards compliance, official docs verification, code accuracy, cross-file consistency, and version drift d353skills.sh installs
3lyndonkl avatargrant-proposal-assistantlyndonkl/claudeGuides creation and review of competitive grant proposals (NIH R01/R21/K, NSF, foundations) by applying reviewer-perspective thinking to ensure clear hypotheses353skills.sh installs
4gohypergiant avataraccelint-ts-testinggohypergiant/agent-skillsComprehensive vitest testing guidance for TypeScript projects. Use when (1) Writing new tests with AAA pattern, parameterized tests, or async/await, (2) Reviewi350skills.sh installs
5anthropics avatarprior-auth-review-skillanthropics/healthcareAutomate payer review of prior authorization (PA) requests. This skill should be used when users say "Review this PA request", "Process prior authorization for 349skills.sh installs
6guia-matthieu avatardotcom-secretsguia-matthieu/clawfu-skillsBuild high-converting sales funnels using Russell Brunson's proven framework Use when: **Launching an online product** and need a complete funnel strategy; **Co349skills.sh installs