A Complete Guide to Spring Boot AI Agent Skills

1. Spring Boot‑specific Agent Skills

Several open‑source Skill packs target Spring Boot development directly:

Dr JSkill – a scaffold generator that follows Julien Dubois’s best‑practice conventions, supporting Java 25, PostgreSQL, Docker, and optional front‑ends (Vue, React, Angular, Vanilla JS). Install by cloning the repository into the .claude/skills directory; the Agent discovers it automatically.

Spring Boot Skills Collection – a production‑grade set of Skills covering REST API design, testing strategy, MCP Java SDK, and database migration. Each Skill bundles SKILL.md, conventions.md, example code, and templates, enabling the Agent to both reason and emit ready‑to‑copy code.

Spring Boot Skills Marketplace – a progressive architecture catalogue (Layered → Package‑by‑Module → Modular Monolith → Tomato → DDD+Hexagonal) that recommends the simplest viable architecture based on project size, avoiding premature DDD.

Spring Boot Engineer Subagent – an expert sub‑agent for Spring Boot 3+, microservices, WebFlux, Spring Cloud, and GraalVM native images. It guarantees >88% test coverage, ~2.3 s startup time, and a 75% memory reduction with GraalVM.

Java Architect Subagent – an enterprise‑level Java architect Skill covering Java 17+ LTS, Spring Boot, microservices, reactive programming, and SOLID principles, with the same quality thresholds as the Engineer sub‑agent.

2. Large‑Scale Skill Collections Containing Spring Boot Items

Beyond the dedicated Spring Boot packs, broader Skill collections also ship Spring‑related entries:

Antigravity Awesome Skills (⭐ 38.9k) – a massive repository (1,480+ Skills) compatible with Claude Code, Codex, Gemini CLI, and Cursor. Spring‑related Skills appear under 02-language-specialists/ (e.g., API design, database optimization, TDD, security).

VoltAgent Awesome Agent Skills (⭐ 23.3k) – includes 135 agents, 35 curated Skills, 42 commands, and 176+ plugins. Spring Boot roles such as spring-boot-engineer and java-architect are provided.

Awesome Claude Code Toolkit (⭐ 1.8k) – a curated set of 1,000+ Skills, also exposing Spring‑related Skills in the same categories.

3. Spring AI Integration

The Spring AI community has re‑implemented the Skills concept as a first‑class Spring AI tool:

spring‑ai‑agent‑utils – provides a SkillsTool that can be registered with a ChatClient. Skills can be packaged as Maven/Gradle artifacts (SkillsJar) for team‑wide distribution.

Example registration:

ChatClient chatClient = chatClientBuilder
    .defaultToolCallbacks(SkillsTool.builder()
        .addSkillsDirectory(".claude/skills")
        .build())
    .defaultTools(FileSystemTools.builder().build())
    .defaultTools(ShellTools.builder().build())
    .build();

Official Spring blog demonstrates a Code Reviewer Skill that checks for security vulnerabilities, proper use of @Service / @Repository, null‑pointer risks, and suggests improvements with line‑by‑line code examples.

4. Creating Your Own Spring Boot Skill

To author a custom Skill, follow these steps:

Create a directory under .claude/skills/your-skill-name.

Add a SKILL.md file (keep under 500 tokens) describing the name, description, and trigger conditions such as “When the user asks to create a REST controller…”.

Optionally add a references/ folder for large examples or specifications.

Provide templates/ with ready‑to‑copy code snippets.

Commit the Skill to version control so the whole team can share it.

Best‑practice guidelines include limiting the core markdown size, using explicit “when the user asks…” phrasing, including positive/negative examples, reusing templates, and sharing via Git.

5. Project‑Level CLAUDE.md Template

A CLAUDE.md file supplies project‑wide context for every Agent interaction. Example sections:

Project name and technology stack (Spring Boot 4.x, Java 25, PostgreSQL, Redis, Docker/K8s).

Key commands (e.g., ./mvnw spring-boot:run, ./mvnw test, ./mvnw clean package -DskipTests).

Code conventions (constructor injection, limited @Transactional, DTO usage, SLF4J logging).

Installed Skills list (e.g., spring-boot-rest-api, spring-boot-testing, code-reviewer).

6. Recommended Spring Boot + Agent Skills Workflow

Standard pipeline:

1. Exploration – Agent reads the codebase to understand architecture.
2. Planning – Use /plan mode; Agent outputs an implementation plan.
3. Coding – Agent executes the plan, automatically loading matching Skills.
4. Verification – Run tests; ensure all pass.
5. Commit – Git commit and push.

For complex projects, assign specialized sub‑agents (Architect, Developer, Tester, Security Auditor) each with a dedicated Skill set (Java Architect, Spring Boot Engineer, TDD Mastery, Security Hardening, Code Reviewer).

7. References

Dr JSkill – https://github.com/jdubois/dr-jskill

Spring Boot Skills Collection – https://github.com/rrezartprebreza/spring-boot-skills

Spring Boot Skills Marketplace – https://github.com/a-pavithraa/springboot-skills-marketplace

Antigravity Awesome Skills – https://github.com/sickn33/antigravity-awesome-skills

VoltAgent Awesome Agent Skills – https://github.com/VoltAgent/awesome-agent-skills

Awesome Claude Code Toolkit – https://github.com/rohitg00/awesome-claude-code-toolkit

Spring AI Agent Utils – https://github.com/spring-ai-community/spring-ai-agent-utils

Spring AI Agent Skills Blog – https://spring.io/blog/2026/01/13/spring-ai-generic-agent-skills

CLAUDE MD Java – https://github.com/ruvnet/ruflo/wiki/CLAUDE-MD-Java