spring-boot-openapi-documentation SKILL.md skillA
spring-boot-openapi-documentation from giuseppe-trisciuoglio/developer-kit is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.
mdr add giuseppe-trisciuoglio/developer-kit/spring-boot-openapi-documentation@git:20260324.a02e282Pins git:20260324.a02e282 in mdr.lock. Pin the fingerprint instead.
- Audit grade
- A, 17 of 17 checks passed
- Kind
- SKILL.md skill
- Repository
- giuseppe-trisciuoglio/developer-kit
- Path
plugins/developer-kit-java/skills/spring-boot-openapi-documentation/SKILL.md- Versions recorded
- 5
- Latest version
- git:20260324.a02e282, committed Mar 24, 2026
- First version recorded
- Feb 8, 2026
- Size
- 10,363 bytes
- Repository stars
- 367
- License
- MIT
Provides patterns to generate comprehensive REST API documentation using SpringDoc OpenAPI 3.0 and Swagger UI in Spring Boot 3.x applications. Use when setting up API documentation, configuring Swagger UI, adding OpenAPI annotations, implementing security documentation, or enhancing REST endpoints with examples and schemas.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# 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. ## When to Use - Set up SpringDoc OpenAPI in Spring Boot 3.x projects - Generate OpenAPI 3.0 specifications for REST APIs - Configure and customize Swagger UI - Add detailed API documentation with annotations - Document request/response models with validation - Implement API security documentation (JWT, OAuth2, Basic Auth) - Document pageable and sortable endpoints - Add examples and schemas to API endpoints - Customize OpenAPI definitions programmatically - Support multiple API groups and versions - Document error responses and exception handlers - Add JSR-303 Bean Validation to API documentation - Support Kotlin-based Spring Boot APIs ## Quick Reference | Concept | Description | |---------|-------------| | **Dependencies** | `springdoc-openapi-starter-webmvc-ui` for WebMvc, `springdoc-openapi-starter-webflux-ui` for WebFlux | | **Configuration** | `application.yml` with `springdoc.api-docs.*` and `springdoc.swagger-ui.*` properties | …
Read the whole file at its exact version.
How to install
mdr add giuseppe-trisciuoglio/developer-kit/spring-boot-openapi-documentation@sha256:1aa77b5c078f4397The line at the top of this page pins the label git:20260324.a02e282, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
[](https://markdownregistry.com/a/art_7oj3gnbqge2k2k7h)
5 badge image fetches in 30 days. What the badge shows.
Versions
The registry has recorded 5 versions of this file, between Feb 8, 2026 and Mar 24, 2026, about one every 11 days.
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260324.a02e282 latest | 2026-03-24 | a02e282 | 10,363 B | A | view · diff |
| git:20260323.300f036 | 2026-03-23 | 300f036 | 8,179 B | A | view · diff |
| git:20260316.91dc3c4 | 2026-03-16 | 91dc3c4 | 21,212 B | A | view · diff |
| git:20260223.c6d4db1 | 2026-02-23 | c6d4db1 | 21,198 B | A | view · diff |
| v1.1.0 | 2026-02-08 | 147afce | 21,299 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (10363 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
giuseppe-trisciuoglio/developer-kit · 367 stars · license MIT · pushed 2026-09-10 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_7oj3gnbqge2k2k7h GET https://markdownregistry.com/api/v1/resolve?ref=giuseppe-trisciuoglio/developer-kit/spring-boot-openapi-documentation GET https://markdownregistry.com/api/v1/blob/1aa77b5c078f439702cbf9e404e54d3939eed252770be1b293015ec2624ec910
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.