Spring Boot Openapi Documentation

If you're building REST APIs with Spring Boot 3.x and need proper OpenAPI 3.0 documentation, this handles the SpringDoc setup and annotation patterns. It covers the dependency configuration, Swagger UI customization, documenting controllers and models with the right annotations, and setting up security schemes for JWT or OAuth2. The skill includes patterns for pagination with Spring Data's Pageable, validation integration with JSR-303, and organizing endpoints with tags and groups. Worth noting it emphasizes keeping annotations minimal to avoid cluttering your controllers and warns about circular references in DTOs causing schema generation issues. Solid reference if you want comprehensive API docs without manually writing OpenAPI specs.

skills.sh installs: 4.2K
GitHub stars: 369
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add giuseppe-trisciuoglio/developer-kit --skill spring-boot-openapi-documentation --agent claude-code

Installs into .claude/skills of the current project.

Files

Spring Boot OpenAPI Documentation with SpringDoc

Overview

SpringDoc OpenAPI automates generation of OpenAPI 3.0 documentation for Spring Boot projects with a Swagger UI web interface for exploring and testing APIs.