A Field Guide to Spring Boot Agent Skills: Scaffolding, Subagents, and the Spring AI Bridge
1. Spring Boot-Specific Agent Skills
The following Skills are designed specifically for Spring Boot development, directly improving the coding quality of AI Agents in Spring Boot projects.
1.1 Dr JSkill — Spring Boot Project Scaffolding (⭐ 251)
| Dimension | Description |
|---|---|
| Repository | https://github.com/jdubois/dr-jskill |
| Author | Julien Dubois (Founder of JHipster) |
| Function | Generates Spring Boot 4.x project scaffolding following Julien Dubois' best practices |
| Features | Java 25, PostgreSQL, Docker support, optional Vue.js / React / Angular / Vanilla JS frontend |
| Compatibility | Claude Code, GitHub Copilot CLI, Windsurf |
| Installation | Clone to the skills directory, AI Agent auto-discovers it |
Core Value: A Skill personally designed by the founder of JHipster. The generated project structure follows the industry's strictest Spring Boot conventions, making it an ideal starting point for new projects.
1.2 Spring Boot Skills Collection — Production-Grade Development Standards
| Dimension | Description |
|---|---|
| Repository | https://github.com/rrezartprebreza/spring-boot-skills |
| Function | A collection of production-grade AI coding Agent Skills designed for daily Spring Boot development |
| Core Philosophy | "AI is good at Python, but hallucinates on Spring Boot. This repo teaches the Agent to code like a senior Spring engineer." |
| Included Skills | REST API specifications, testing strategies, MCP Java SDK, database migrations, etc. |
| Skill Structure | Each skill contains SKILL.md + conventions.md + examples/ + templates/ |
| Installation | Clone individual skill directories into .claude/skills/ |
Core Value: Each Skill is a complete combination of "conventions + examples + templates". The Agent not only knows what to do but can also directly copy the correct code templates.
1.3 Spring Boot Skills Marketplace — Progressive Architecture Patterns (⭐ 47)
| Dimension | Description |
|---|---|
| Repository | https://github.com/a-pavithraa/springboot-skills-marketplace |
| Function | A progressive collection of Spring Boot architecture pattern Skills, compatible with Claude Code and Codex |
| Architecture Patterns | Layered → Package-by-Module → Modular Monolith → Tomato → DDD+Hexagonal |
| Design Philosophy | "Start simple, and only add complexity when complexity requires it." |
| Included Content | Spring Data JPA references, testing Skills, architecture evolution path guides |
| Installation | npx skills add or manual cloning |
Core Value: Avoids over-engineering. The Agent recommends an appropriate architecture pattern based on the project scale, rather than jumping straight to DDD.
1.4 Spring Boot Engineer — Senior Coding Subagent
| Dimension | Description |
|---|---|
| Repository | https://github.com/VoltAgent/awesome-claude-code-subagents |
| Role | Senior Spring Boot Engineer Subagent |
| Expertise | Spring Boot 3+, Microservices architecture, WebFlux reactive, Spring Cloud, GraalVM Native |
| Workflow | Architecture Planning → Implementation → Spring Boot Excellence (3 phases) |
| Quality Standards | 88%+ test coverage, 2.3s startup time, 75% memory reduction with GraalVM Native |
Core Value: Used as an independent Subagent, suitable for multi-agent collaboration models where "experts do expert things."
1.5 Java Architect — Enterprise Architecture Subagent
| Dimension | Description |
|---|---|
| Repository | https://github.com/VoltAgent/awesome-claude-code-subagents |
| Role | Enterprise Java Architect Subagent |
| Expertise | Java 17+ LTS, Spring Boot, Microservices, Reactive Programming, SOLID Principles |
| Workflow | Architecture Analysis → Enterprise Implementation → Quality Assurance |
| Quality Standards | 88%+ test coverage, 2.3s startup time, 75% memory reduction with GraalVM Native |
Core Value: Invoked during the architecture design phase of complex systems to ensure reasonable overall technology selection and layered design.
2. Spring Boot Related Skills in Large Skill Collections
The following large Skill collections contain numerous Skills directly related to Spring Boot / Java development.
2.1 Antigravity Awesome Skills (⭐ 38.9k, 1,480+ Skills)
| Dimension | Description |
|---|---|
| Repository | https://github.com/sickn33/antigravity-awesome-skills |
| Installation | npx antigravity-awesome-skills --claude |
15 Skills Related to Spring Boot:
| Skill Name | Description | Applicable Scenarios |
|---|---|---|
| java-architect | Enterprise Java Architect | System architecture design, technology selection |
| spring-boot-engineer | Spring Boot 3+ Expert | Daily development, microservice implementation |
| api-design-principles | REST/GraphQL API Design Principles | API interface design |
| database-optimization | Database Optimization | Query tuning, indexing strategies |
| tdd-mastery | Red-Green-Refactor Test-Driven Development | Test writing |
| security-hardening | Security Hardening | Input validation, authentication patterns |
| code-refactoring-refactor-clean | Refactoring Expert | Code cleanup, SOLID principles |
| production-code-audit | Production-Grade Code Audit | Pre-release review |
| cqrs-implementation | CQRS Architecture Implementation | Read/write separation architecture |
| ddd-strategic-design | DDD Strategic Design | Bounded context division |
| ddd-tactical-patterns | DDD Tactical Patterns | Aggregates, Value Objects, Domain Events |
| event-sourcing-architect | Event Sourcing Architecture | Event-driven systems |
| postgres-best-practices | PostgreSQL Best Practices | Database design |
| sql-optimization-patterns | SQL Optimization Patterns | Slow query optimization |
| monorepo-architect | Monorepo Architecture | Large multi-module Spring projects |
2.2 VoltAgent Awesome Agent Skills (⭐ 23.3k, 1,000+ Skills)
| Dimension | Description |
|---|---|
| Repository | https://github.com/VoltAgent/awesome-agent-skills |
| Installation | Manually configure the skills directory after git clone |
A curated collection similar to Antigravity, compatible with Claude Code / Codex / Gemini CLI / Cursor. Java-related Skills are categorized under the 02-language-specialists/ directory, including role Subagents like Spring Boot Engineer and Java Architect.
2.3 Awesome Claude Code Toolkit (⭐ 1.8k)
| Dimension | Description |
|---|---|
| Repository | https://github.com/rohitg00/awesome-claude-code-toolkit |
| Installation | Manually configure the skills directory after cloning |
Contains 135 agents + 35 curated skills + 42 commands + 176+ plugins. Spring Boot-related Skills are located in directories like API Design, Database Optimization, TDD, and Security.
3. Agent Skills Support in Spring AI
The Spring AI community has integrated the Agent Skills concept into the Spring ecosystem, allowing AI Agents to run inside Spring Boot applications and load Skills.
This is quite interesting—using Spring AI-related skills to develop AI Agents.
3.1 Spring AI Agent Utils (⭐ 460)
| Dimension | Description |
|---|---|
| Repository | https://github.com/spring-ai-community/spring-ai-agent-utils |
| Function | Re-implements Claude Code's Skills concept as Spring AI tools |
| SkillsJar | Can package Skills as Maven/Gradle dependencies for distribution across teams |
| Integration Method | Register Skills in ChatClient via SkillsTool |
Code Example:
ChatClient chatClient = chatClientBuilder
.defaultToolCallbacks(SkillsTool.builder()
.addSkillsDirectory(".claude/skills")
.build())
.defaultTools(FileSystemTools.builder().build())
.defaultTools(ShellTools.builder().build())
.build();
3.2 Official Example: Creating a Code Reviewer Skill in Spring Boot
The official Spring blog demonstrates how to define and load Skills within a Spring Boot application:
| Dimension | Description |
|---|---|
| Source | Spring AI Official Blog |
| Purpose | Create a reusable AI Agent Skill inside a Spring Boot application |
mkdir -p .claude/skills/code-reviewer
cat > .claude/skills/code-reviewer/SKILL.md << 'EOF'
---
name: code-reviewer
description: Reviews Java code for best practices, security issues, and Spring Framework conventions.
Use when user asks to review, analyze, or audit code.
---
# Code Reviewer
## Instructions
When reviewing code:
1. Check for security vulnerabilities (SQL injection, XSS, etc.)
2. Verify Spring Boot best practices (proper use of @Service, @Repository, etc.)
3. Look for potential null pointer exceptions
4. Suggest improvements for readability and maintainability
5. Provide specific line-by-line feedback with code examples
EOF
4. How to Write Your Own Skill for a Spring Boot Project
4.1 Creation Steps
# 1. Create skill directory
mkdir -p .claude/skills/spring-boot-rest-api
# 2. Create SKILL.md
cat > .claude/skills/spring-boot-rest-api/SKILL.md << 'EOF'
---
name: spring-boot-rest-api
description: Best practices for writing Spring Boot REST APIs. Automatically activates when the user asks to create a Controller, DTO, or REST endpoint.
---
# Spring Boot REST API Development Guide
## Trigger Conditions
- Creating a new REST Controller
- Writing DTO / VO classes
- Designing API response formats
## Core Rules
1. Use @RestController + @RequestMapping
2. Wrap all responses uniformly in a Result<T> format
3. Use @Valid for request parameter validation
4. Use @ControllerAdvice for global exception handling
5. Use Pageable parameters for paginated queries
## Code Examples
(see references/ directory)
EOF
# 3. Create reference files
mkdir -p .claude/skills/spring-boot-rest-api/references
4.2 Best Practices for Writing
| Principle | Description |
|---|---|
| Control Size | Keep SKILL.md under 500 tokens; move excess content to the references/ directory for on-demand loading |
| Clear Triggers | Use phrasing like "When the user asks to..." for trigger conditions |
| Positive/Negative Comparisons | Include comparisons of good and bad examples to help the Agent understand "what good code looks like" |
| Template Reuse | Use template files placed in the templates/ directory for the Agent to copy and use |
| Team Sharing | Commit to version control for team sharing |
5. CLAUDE.md Template for Spring Boot Projects
CLAUDE.md is project-level context loaded in every conversation, working best in conjunction with Skills.
# Project Name
## Tech Stack
- Spring Boot 4.x / Java 25
- PostgreSQL + JPA/Hibernate
- Spring Security + JWT
- Redis Cache
- Docker + Kubernetes
## Key Commands
- `./mvnw spring-boot:run` — Start development server
- `./mvnw test` — Run tests
- `./mvnw clean package -DskipTests` — Package
## Code Conventions
- Constructor injection (do not use @Autowired field injection)
- Do not add @Transactional at the Service class level (only on methods that need it)
- Do not expose Entities directly to the API (use DTOs for conversion)
- Use SLF4J for logging, not System.out
## Skills
This project has the following Skills installed:
- spring-boot-rest-api: REST API development
- spring-boot-testing: Test writing
- code-reviewer: Code review
6. Recommended Spring Boot + Agent Skills Workflow
6.1 Standard Workflow
1. Exploration Phase: Let the Agent read the codebase and understand the architecture
2. Planning Phase: Use /plan mode, Agent outputs an implementation plan
3. Coding Phase: Agent implements step-by-step according to the plan (automatically loads matching Skills)
4. Verification Phase: Run tests, confirm they pass
5. Commit Phase: Git commit + push
6.2 Multi-Agent Collaboration Mode
For complex Spring Boot projects, different Skills can be assigned by role:
| Agent Role | Responsibility | Recommended Skill |
|---|---|---|
| Architect | Design microservice architecture, module splitting | Java Architect |
| Developer | Write specific code | Spring Boot Engineer / Dr JSkill |
| Test Engineer | Write and run tests | TDD Mastery |
| Security Auditor | Scan for security vulnerabilities | Security Hardening |
| Code Reviewer | Code quality gatekeeping | Code Reviewer |