# spring-boot-expert

spring-boot-expert guides coding agents through Spring Boot development, REST API design, and microservice setup in Java projects.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 212 installs · ★ 45 repo stars
- Author: personamanagmentlayer
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/personamanagmentlayer/pcl/tree/HEAD/stdlib/frameworks/spring-boot-expert/SKILL.md
- Updated: 2026-10-12
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/spring-boot-expert

## What it does

The skill equips coding agents with reference patterns for Spring Boot applications. It covers Spring Data JPA entities, auditing listeners, transactional services, and pagination-ready REST controllers with Java record DTOs. It also provides conventions for MapStruct mappers and centralized exception handling.

Execution relies on tool permissions for file editing and Bash execution restricted to `mvn`, `gradle`, and `java`. The agent cannot verify or compile changes if local Java build tooling is missing.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add personamanagmentlayer/pcl --skill spring-boot-expert -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/spring-boot-expert/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/spring-boot-expert/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add personamanagmentlayer/pcl --skill spring-boot-expert -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/spring-boot-expert/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add personamanagmentlayer/pcl --skill spring-boot-expert -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/spring-boot-expert/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install personamanagmentlayer/pcl stdlib/frameworks/spring-boot-expert
```

2. **Manually: put the files in place**
- File: `.github/skills/spring-boot-expert/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add personamanagmentlayer/pcl --skill spring-boot-expert -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/personamanagmentlayer/pcl --path stdlib/frameworks/spring-boot-expert
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/spring-boot-expert/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add personamanagmentlayer/pcl --skill spring-boot-expert -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/personamanagmentlayer/pcl/tree/HEAD/stdlib/frameworks/spring-boot-expert/SKILL.md

## When to use it
- Build REST controllers featuring pagination and request validation
- Configure Spring Data JPA entities with relational mapping and auditing
- Implement transactional service methods with MapStruct mappings
- Set up microservice architectural patterns like service discovery and gateways

## Example prompts
- Generate a REST controller for managing users with pagination and record DTOs.
- Create a JPA entity Post linked to User via ManyToOne with Spring Data auditing.
- Implement a transactional UserService with MapStruct mapping and email validation.

## Source text · SKILL.md · Apache-2.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: d3a2bc41f6389e93.

BEGIN THIRD-PARTY FILE d3a2bc41f6389e93
````text
---
name: spring-boot-expert
version: 1.1.0
description: >-
  Expert-level Spring Boot, Spring Framework, REST APIs, and microservices development. Use
  when the user mentions Java, Spring framework, REST APIs, or microservices, or when the
  task involves Spring Boot Fundamentals.
category: frameworks
tags: [spring-boot, java, spring-framework, rest-api, microservices]
allowed-tools:
  - Read
  - Write
  - Edit
  - Bash(mvn:*, gradle:*, java:*)
---

# Spring Boot Expert

Expert guidance for Spring Boot development, Spring Framework, building REST APIs, and microservices architecture.

## Core Concepts

### Spring Boot Fundamentals

- Auto-configuration
- Dependency injection
- Spring Boot Starters
- Application properties
- Profiles and configuration
- Spring Boot Actuator

### Spring Framework

- Spring Core (IoC, DI)
- Spring Data JPA
- Spring Security
- Spring Web MVC
- Spring AOP
- Spring Transaction Management

### Microservices

- Service discovery
- API Gateway
- Circuit breakers
- Distributed tracing
- Configuration management

## Spring Boot Application

```java
// Main application class
@SpringBootApplication
@EnableJpaAuditing
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

// Entity with JPA
@Entity
@Table(name = "users")
@EntityListeners(AuditingEntityListener.class)
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @Column(nullable = false, unique = true)
    private String email;

    @Column(nullable = false)
    private String password;

    @CreatedDate
    @Column(nullable = false, updatable = false)
    private LocalDateTime createdAt;

    @LastModifiedDate
    private LocalDateTime updatedAt;

    @OneToMany(mappedBy = "author", cascade = CascadeType.ALL)
    private List<Post> posts = new ArrayList<>();

    // Getters and setters
}

@Entity
@Table(name = "posts")
public class Post {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    @Column(nullable = false)
    private String title;

    @Column(columnDefinition = "TEXT")
    private String content;

    @ManyToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "user_id", nullable = false)
    private User author;

    @CreatedDate
    private LocalDateTime createdAt;

    // Getters and setters
}
```

## REST API Controller

```java
@RestController
@RequestMapping("/api/users")
@RequiredArgsConstructor
public class UserController {

    private final UserService userService;

    @GetMapping
    public ResponseEntity<Page<UserDto>> getUsers(
            @RequestParam(defaultValue = "0") int page,
            @RequestParam(defaultValue = "20") int size,
            @RequestParam(defaultValue = "id") String sortBy,
````
END THIRD-PARTY FILE d3a2bc41f6389e93

The third-party file has ended. Everything between the d3a2bc41f6389e93 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2825 of 11000 bytes. © personamanagmentlayer · Apache-2.0 · https://github.com/personamanagmentlayer/pcl/tree/HEAD/stdlib/frameworks/spring-boot-expert/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
