Agent skill

Spring Boot Migration

by benchflow-ai in benchflow-ai/skillsbench

Migrate Spring Boot 2.x applications to Spring Boot 3.x. An agent skill from benchflow-ai/skillsbench.

Apache-2.0Auto-check passedBackend & APIs

Install Spring Boot Migration

skills CLI
$ npx skills add benchflow-ai/skillsbench --skill spring-boot-migration -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install benchflow-ai/skillsbench spring-boot-migration --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/benchflow-ai/skillsbench.git skills-src && mkdir -p .claude/skills && cp -r skills-src/tasks/spring-boot-jakarta-migration/environment/skills/spring-boot-migration .claude/skills/spring-boot-migration && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
spring-boot-migration
GitHub stars
1.8k
Token cost
~2.2k tokens
SKILL.md length
497 words
Files
1
Skills in repo
180
Repo updated
First seen
Licence
Apache-2.0

At a glance

Migrate Spring Boot 2.x applications to Spring Boot 3.x. An agent skill from benchflow-ai/skillsbench.

  • Works in 4 steps: Update Spring Boot Version → Update Java Version → Remove Deprecated Dependencies… → …
  • Updating pom.xml versions
  • SKILL.md covers Overview, Key Migration Steps, Common Issues and Migration Commands, plus 5 more sections
  • Calls mvn

What it does

Spring Boot Migration is an agent skill from benchflow-ai/skillsbench. Migrate Spring Boot 2.x applications to Spring Boot 3.x. Use when updating pom.xml versions, removing deprecated JAXB dependencies, upgrading Java to 17/21, or using OpenRewrite for automated migration. Covers dependency updates, version changes, and migration checklist.

Its SKILL.md is about 2.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs, covering Backend development. It works with Spring Boot and Java. The repository describes itself as: SkillsBench evaluates how well skills work and how effective agents are at using them. The licence is Apache-2.0.

When your agent uses it

  • Updating pom.xml versions
  • Removing deprecated JAXB dependencies
  • Upgrading Java to 17/21
  • Using OpenRewrite for automated migration

Example prompts

  • “/spring-boot-migration”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Update Spring Boot Version
  2. Update Java Version
  3. Remove Deprecated Dependencies (CRITICAL: JAXB API)
  4. Update JWT Library

What it can do on your machine

Read from SKILL.md and the folder at commit 9a1f4dd. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • mvn

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com
    • docs.openrewrite.org
    • baeldung.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Spring Boot Migration loads about 2.2k tokens when it runs. Until then it costs about 73 tokens; SKILL.md has 497 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~73
When it runs · the whole SKILL.md, loaded when a task matches
~2.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from benchflow-ai/skillsbench at commit 9a1f4dd, republished under its Apache-2.0 licence (© benchflow-ai). 497 words, ~2,183 tokens.

Download SKILL.mdSave it as .claude/skills/spring-boot-migration/SKILL.md (or your agent's skills folder).
name
spring-boot-migration
description
Migrate Spring Boot 2.x applications to Spring Boot 3.x. Use when updating pom.xml versions, removing deprecated JAXB dependencies, upgrading Java to 17/21, or using OpenRewrite for automated migration. Covers dependency updates, version changes, and migration checklist.

Spring Boot 2 to 3 Migration Skill

Overview

This skill provides guidance for migrating Spring Boot applications from version 2.x to 3.x, which is one of the most significant upgrades in Spring Boot history due to the Java EE to Jakarta EE transition.

Key Migration Steps

1. Update Spring Boot Version

Change the parent POM version:

xml
<!-- Before: Spring Boot 2.7.x -->
<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>2.7.18</version>
</parent>

<!-- After: Spring Boot 3.2.x -->
<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>3.2.0</version>
</parent>
2. Update Java Version

Spring Boot 3 requires Java 17 or later:

xml
<properties>
    <!-- Before -->
    <java.version>1.8</java.version>

    <!-- After -->
    <java.version>21</java.version>
</properties>
3. Remove Deprecated Dependencies (CRITICAL: JAXB API)

You MUST remove the old javax.xml.bind:jaxb-api dependency. This is a Java EE dependency that was commonly added for Java 9+ compatibility in Spring Boot 2.x projects, but it conflicts with Jakarta EE in Spring Boot 3.

Dependencies to REMOVE from pom.xml
xml
<!-- REMOVE ALL OF THESE - they are incompatible with Spring Boot 3 -->

<!-- Old JAXB API - MUST BE REMOVED -->
<dependency>
    <groupId>javax.xml.bind</groupId>
    <artifactId>jaxb-api</artifactId>
</dependency>

<!-- Old JAXB Implementation - MUST BE REMOVED -->
<dependency>
    <groupId>com.sun.xml.bind</groupId>
    <artifactId>jaxb-impl</artifactId>
</dependency>

<dependency>
    <groupId>com.sun.xml.bind</groupId>
    <artifactId>jaxb-core</artifactId>
</dependency>

<!-- Old Java Activation - MUST BE REMOVED -->
<dependency>
    <groupId>javax.activation</groupId>
    <artifactId>activation</artifactId>
</dependency>

<dependency>
    <groupId>javax.activation</groupId>
    <artifactId>javax.activation-api</artifactId>
</dependency>
Why Remove These?
  1. Namespace Conflict: javax.xml.bind uses the old Java EE namespace, which conflicts with Jakarta EE's jakarta.xml.bind
  2. Spring Boot 3 Includes Jakarta XML Bind: If you need XML binding, Spring Boot 3 transitively includes the Jakarta versions
  3. Build Failures: Having both javax.xml.bind and jakarta.xml.bind on the classpath causes ClassNotFoundException and other runtime errors
If You Need XML Binding in Spring Boot 3

Use the Jakarta versions instead:

xml
<!-- Only add these if you actually need XML binding -->
<dependency>
    <groupId>jakarta.xml.bind</groupId>
    <artifactId>jakarta.xml.bind-api</artifactId>
</dependency>
<dependency>
    <groupId>org.glassfish.jaxb</groupId>
    <artifactId>jaxb-runtime</artifactId>
</dependency>
Quick Check for Old JAXB Dependencies
bash
# Check if old JAXB is in your pom.xml
grep -E "javax\.xml\.bind|jaxb-api" pom.xml

# If this returns any results, you need to remove those dependencies
Verify Removal

After removing, confirm no old JAXB references remain:

bash
# This should return NO results
grep -E "<artifactId>jaxb-api</artifactId>" pom.xml
grep -E "javax\.xml\.bind" pom.xml
4. Update JWT Library

The old jjwt library needs to be replaced with the newer modular version:

xml
<!-- Before -->
<dependency>
    <groupId>io.jsonwebtoken</groupId>
    <artifactId>jjwt</artifactId>
    <version>0.9.1</version>
</dependency>

<!-- After -->
<dependency>
    <groupId>io.jsonwebtoken</groupId>
    <artifactId>jjwt-api</artifactId>
    <version>0.12.3</version>
</dependency>
<dependency>
    <groupId>io.jsonwebtoken</groupId>
    <artifactId>jjwt-impl</artifactId>
    <version>0.12.3</version>
    <scope>runtime</scope>
</dependency>
<dependency>
    <groupId>io.jsonwebtoken</groupId>
    <artifactId>jjwt-jackson</artifactId>
    <version>0.12.3</version>
    <scope>runtime</scope>
</dependency>

Common Issues

Issue 1: Compilation Errors After Upgrade

After changing the Spring Boot version, you'll see many compilation errors related to javax.* imports. These need to be changed to jakarta.* (see Jakarta Namespace skill).

Issue 2: H2 Database Dialect

The H2 dialect class name changed:

properties
# Before
spring.jpa.database-platform=org.hibernate.dialect.H2Dialect

# After
spring.jpa.database-platform=org.hibernate.dialect.H2Dialect
# Note: In Hibernate 6, this is often auto-detected and may not need explicit configuration
Issue 3: Actuator Endpoints

Actuator endpoint paths have changed. Review your security configuration if you're exposing actuator endpoints.

Migration Commands

Update pom.xml with sed
bash
# Update Spring Boot parent version
sed -i 's/<version>2\.7\.[0-9]*<\/version>/<version>3.2.0<\/version>/g' pom.xml

# Update Java version
sed -i 's/<java.version>1\.8<\/java.version>/<java.version>21<\/java.version>/g' pom.xml
sed -i 's/<java.version>8<\/java.version>/<java.version>21<\/java.version>/g' pom.xml
sed -i 's/<java.version>11<\/java.version>/<java.version>21<\/java.version>/g' pom.xml

# Remove old JAXB dependency (multi-line removal is complex - manual removal recommended)
Remove Deprecated Dependencies
bash
# Check for old JAXB dependencies
grep -n "jaxb-api\|javax\.xml\.bind" pom.xml

# These must be manually removed from pom.xml:
# - javax.xml.bind:jaxb-api
# - com.sun.xml.bind:jaxb-impl
# - com.sun.xml.bind:jaxb-core
Show full SKILL.md (205 more words)Show less

Using OpenRewrite for Automated Migration

OpenRewrite is the recommended tool for large-scale migrations:

Add OpenRewrite Plugin to pom.xml
xml
<plugin>
    <groupId>org.openrewrite.maven</groupId>
    <artifactId>rewrite-maven-plugin</artifactId>
    <version>5.42.0</version>
    <configuration>
        <activeRecipes>
            <recipe>org.openrewrite.java.spring.boot3.UpgradeSpringBoot_3_2</recipe>
        </activeRecipes>
    </configuration>
    <dependencies>
        <dependency>
            <groupId>org.openrewrite.recipe</groupId>
            <artifactId>rewrite-spring</artifactId>
            <version>5.21.0</version>
        </dependency>
    </dependencies>
</plugin>
Run OpenRewrite Migration
bash
mvn rewrite:run

This will automatically:

  • Update Spring Boot version
  • Migrate javax.* to jakarta.* imports
  • Update deprecated Spring Security patterns
  • Fix property name changes

Verification Steps

Check Spring Boot Version
bash
# Should show 3.x version
grep -A2 "spring-boot-starter-parent" pom.xml | grep version
Check Java Version
bash
# Should show 17 or 21
grep "java.version" pom.xml
Check for Old Dependencies
bash
# All should return NO results
grep "jaxb-api" pom.xml
grep "javax\.xml\.bind" pom.xml
grep "<version>0\.9\.1</version>" pom.xml  # Old jjwt version
Compile and Test
bash
# Compile the project
mvn clean compile

# Run tests
mvn test

Migration Checklist

  • Update spring-boot-starter-parent version to 3.2.x
  • Update java.version to 17 or 21
  • Remove javax.xml.bind:jaxb-api and related JAXB dependencies
  • Remove old io.jsonwebtoken:jjwt if present, replace with modular jjwt
  • Run mvn clean compile to identify remaining issues
  • Fix all javax.* to jakarta.* imports
  • Update Spring Security configuration (see Spring Security 6 skill)
  • Replace RestTemplate with RestClient (see RestClient Migration skill)
  • Run tests to verify functionality
  1. First: Upgrade to Spring Boot 2.7.x (latest 2.x) if not already
  2. Second: Update Java version to 17 or 21
  3. Third: Remove incompatible dependencies (JAXB, old JWT)
  4. Fourth: Update Spring Boot parent to 3.2.x
  5. Fifth: Fix namespace imports (javax → jakarta)
  6. Sixth: Update Spring Security configuration
  7. Seventh: Update HTTP clients (RestTemplate → RestClient)
  8. Finally: Run full test suite

Sources

© benchflow-ai, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in tasks/spring-boot-jakarta-migration/environment/skills/spring-boot-migration of benchflow-ai/skillsbench.

Open the folder on GitHubat commit 9a1f4dd

Compare with similar skills

Spring Boot Migration next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Spring Boot Migration compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Spring Boot Migration this skillbenchflow-ai/skillsbench1.8k—~2.2kAutomated safety check: PassApache-2.0
Spring Bootpiomin/claude-ai-spring-boot1.3k—~2kAutomated safety check: PassApache-2.0
Dr Jskilljdubois/dr-jskill342—~4.6kAutomated safety check: NotesApache-2.0
WxJava Integration Guidebinarywang/WxJava33k—~123Automated safety check: PassApache-2.0
Flycms Devsunkaifei/FlyCms656—~827Automated safety check: PassMIT
Intelliconnect Service Styleruanrongman/IntelliConnect147—~2.4kAutomated safety check: PassApache-2.0

Similar skills

  • Spring Boot

    piomin/claude-ai-spring-boot

    Spring Boot 3.x development - REST APIs, JPA, Security, Testing, and Cloud-native patterns.

    1.3k GitHub stars~2k tokensUpdated 5 mo ago
    Backend & APIsAuto-check passed
  • Dr Jskill

    jdubois/dr-jskill

    Creates Java + Spring Boot projects: Web applications, full-stack apps with Vue.js or Angular or React or vanilla JS, PostgreSQL, REST APIs, and Docker.

    342 GitHub stars~4.6k tokensUpdated 8 days ago
    Backend & APIsAuto-check: notes
  • WxJava Integration Guide

    binarywang/WxJava

    Plans a WxJava setup for Java, Spring Boot or Solon projects that call WeChat services, from module and BOM choice to config and a minimal working call.

    33k GitHub stars~123 tokensUpdated 11 days ago
    Backend & APIsAuto-check passed
  • Flycms Dev

    sunkaifei/FlyCms

    FlyCms 项目(backend/ Spring Boot 4.1.1 + frontend/ vue-vben-admin v5)的架构地图与开发规范总纲。凡在本仓库做任何开发——写后端接口、新增/修改模块、管理页面、数据库变更、修 bug、重构——都要先加载本 skill 再动手,即使用户只说"改一下""加个功能";前端登录/菜单/权限专项另见…

    656 GitHub stars~827 tokensUpdated 5 days ago
    Backend & APIsAuto-check passed
  • Intelliconnect Service Style

    ruanrongman/IntelliConnect

    Create or update IntelliConnect Spring Boot service/serviceimpl code in this repository style.

    147 GitHub stars~2.4k tokensUpdated 3 days ago
    Backend & APIsAuto-check passed
  • Java Coding Standards

    Snailclimb/AIGuide

    Java/Spring Boot 编码规范:用于编写、审查、重构和讲解 Java 代码。适用于 Java 风格、Spring Boot 架构、Controller/Service/Manager/DAO 分层、API 边界、Entity/VO/Form/DTO/BO 设计、MyBatis/MyBatis-Plus 持久化、事务、异常、日志、安全、性能、测试和 Java 代码评审等场景。默认结合…

    667 GitHub stars~1k tokensUpdated 3 mo ago
    Backend & APIsAuto-check passed

More from benchflow-ai/skillsbench

All 180 skills in this repo
  • Lean4 Memories

    benchflow-ai/skillsbench

    This skill should be used when working on Lean 4 formalization projects to maintain persistent memory of successful proof patterns, failed approaches, project conventions, and user preferences…

    1.8k GitHub stars~3.2k tokensUpdated 2 mo ago
    Auto-check passed
  • Senior Data Engineer

    benchflow-ai/skillsbench

    World-class data engineering skill for building scalable data pipelines, ETL/ELT systems, real-time streaming, and data infrastructure.

    1.8k GitHub stars~5.9k tokensUpdated 2 mo ago
    Auto-check passed
  • Ac Branch Pi Model

    benchflow-ai/skillsbench

    AC branch pi-model power flow equations (P/Q and |S|) with transformer tap ratio and phase shift, matching acopf-math-model.md and MATPOWER branch fields.

    1.8k GitHub stars~1.1k tokensUpdated 2 mo ago
    Auto-check passed
  • Civ6lib

    benchflow-ai/skillsbench

    Civilization 6 district mechanics library. An agent skill from benchflow-ai/skillsbench.

    1.8k GitHub stars~1.7k tokensUpdated 2 mo ago
    Auto-check passed
  • D3 Visualization

    benchflow-ai/skillsbench

    Build deterministic, verifiable data visualizations with D3.js (v6).

    1.8k GitHub stars~1.5k tokensUpdated 2 mo ago
    Auto-check passed
  • Dc Power Flow

    benchflow-ai/skillsbench

    DC power flow analysis for power systems. An agent skill from benchflow-ai/skillsbench.

    1.8k GitHub stars~717 tokensUpdated 2 mo ago
    Auto-check passed

Works with

Categories

Questions about Spring Boot Migration

What does Spring Boot Migration do?

Migrate Spring Boot 2.x applications to Spring Boot 3.x. An agent skill from benchflow-ai/skillsbench. Spring Boot Migration is an agent skill from benchflow-ai/skillsbench.x.

When should I use Spring Boot Migration?

Spring Boot Migration fits situations like: updating pom.xml versions; removing deprecated JAXB dependencies; upgrading Java to 17/21; using OpenRewrite for automated migration.

How do I install Spring Boot Migration in Claude Code?

Run `npx skills add benchflow-ai/skillsbench --skill spring-boot-migration -a claude-code`. Or copy the skill folder (tasks/spring-boot-jakarta-migration/environment/skills/spring-boot-migration in benchflow-ai/skillsbench) into .claude/skills/spring-boot-migration in your project. Claude Code loads it when a task matches its description.

How do I install Spring Boot Migration in Codex?

Run `npx skills add benchflow-ai/skillsbench --skill spring-boot-migration -a codex`. Or copy the skill folder (tasks/spring-boot-jakarta-migration/environment/skills/spring-boot-migration in benchflow-ai/skillsbench) into .agents/skills/spring-boot-migration in your project. Codex loads it when a task matches its description.

Can I use Spring Boot Migration in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add benchflow-ai/skillsbench --skill spring-boot-migration -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/spring-boot-migration, .gemini/skills/spring-boot-migration, .github/skills/spring-boot-migration and .opencode/skills/spring-boot-migration in your project.

What does Spring Boot Migration need to run?

Going by SKILL.md and its folder, Spring Boot Migration needs the command-line tools its instructions call (mvn).

Does Spring Boot Migration access the network?

SKILL.md names 3 domains. As links in the text: github.com, docs.openrewrite.org and baeldung.com. This is read from the text; nothing was executed.

Is Spring Boot Migration safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Spring Boot Migration use?

Spring Boot Migration is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Spring Boot Migration use?

About 2.2k tokens (SKILL.md is roughly 8.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Spring Boot Migration?

Skills that share tags, products or a category with Spring Boot Migration: Spring Boot (piomin/claude-ai-spring-boot, 1.3k stars), Dr Jskill (jdubois/dr-jskill, 342 stars), WxJava Integration Guide (binarywang/WxJava, 33k stars) and Flycms Dev (sunkaifei/FlyCms, 656 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Spring Boot Migration?

benchflow-ai (a GitHub organization) maintains it in benchflow-ai/skillsbench, which has 1,832 GitHub stars. The repository holds 180 skills in this directory. The repository was last updated on July 23, 2026.

Source: benchflow-ai/skillsbench on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.