Can it document Spring Data Pageable objects?

Yes, it includes specific instructions for using the @ParameterObject annotation to properly document pagination and sorting parameters.

Does this skill support Spring Boot 3?

Yes, it is specifically designed for Spring Boot 3.x applications using the modern SpringDoc OpenAPI library.

How do I access the generated documentation?

By default, the skill helps you configure Swagger UI at /swagger-ui/index.html and the OpenAPI JSON specification at /v3/api-docs.

Can I document secure APIs with this skill?

Absolutely, it includes implementation patterns for JWT Bearer, OAuth2, and Basic Auth security schemes.

Does it support both WebMvc and WebFlux?

Yes, the skill provides the correct dependencies and configuration patterns for both standard and reactive Spring applications.

Spring Boot OpenAPI Documentation

Name: Spring Boot OpenAPI Documentation
Author: giuseppe-trisciuoglio

bygiuseppe-trisciuoglio

•

125

•

API Development

Automates the generation of comprehensive OpenAPI 3.0 specifications and interactive Swagger UI for Spring Boot 3.x applications.

This skill provides standardized patterns and implementation guides for integrating SpringDoc OpenAPI into Spring Boot projects, ensuring your REST APIs are professional and self-documenting. It enables developers to automatically generate interactive Swagger UI documentation, apply detailed OpenAPI annotations to controllers and models, configure security schemes like JWT or OAuth2, and handle complex scenarios such as pagination and multi-group API versioning. By using this skill, Claude can help you maintain high-quality API contracts that simplify frontend integration and improve developer experience.

Key Features

01Comprehensive annotation patterns for controllers, DTOs, and security

02125 GitHub stars

03Advanced configuration for API grouping, versioning, and custom extensions

04Support for Spring Data pagination, sorting, and JSR-303 validation

05Automated OpenAPI 3.0 specification generation for WebMvc and WebFlux

06Interactive Swagger UI integration for live API testing and exploration

Use Cases

01Documenting legacy REST endpoints with clear schemas, examples, and error responses

02Configuring secure API access documentation using JWT Bearer or OAuth2 flows

03Setting up standardized API documentation for a new Spring Boot microservice

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add giuseppe-trisciuoglio/developer-kit spring-boot-openapi-documentation

For use in Claude.ai and ChatGPT

Download Skill