rrezartprebreza/spring-boot-skills / skills/spring-boot-4/openapi-first
openapi-first
VerifiedUse when the project follows API-first / OpenAPI-first approach: generating controller interfaces, DTOs, and clients from an OpenAPI spec. Use when you see openapi.yaml, openapi-generator-maven-plugin, or ApiDelegate pattern in the project.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.4 KB |
| agents/openai.yaml | config | 192 B |
| examples/bad-delegate-impl.java | other | 1.5 KB |
| examples/good-delegate-impl.java | other | 1.6 KB |
| templates/openapi.yaml | config | 4.1 KB |
templates/openapi.yaml
View on GitHubopenapi: 3.0.3
info:
title: Order API
version: 1.0.0
description: Order management REST API
servers:
- url: http://localhost:8080/api/v1
paths:
/orders:
get:
operationId: listOrders
summary: List orders with pagination
tags: [Orders]
parameters:
- name: page
in: query
schema: { type: integer, default: 0 }
- name: size
in: query
schema: { type: integer, default: 20 }
responses:
'200':
description: Paginated list of orders
content:
application/json:
schema:
$ref: '#/components/schemas/PageOrder'
post:
operationId: createOrder
summary: Create a new order
tags: [Orders]
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/CreateOrderRequest'
responses:
'201':
description: Order created
content:
application/json:
schema:
$ref: '#/components/schemas/Order'
'400':
$ref: '#/components/responses/ValidationError'
/orders/{id}:
get:
operationId: getOrderById
summary: Get order by ID
tags: [Orders]
parameters:
- $ref: '#/components/parameters/OrderId'
responses:
'200':
description: Order found
content:
application/json:
schema:
$ref: '#/components/schemas/Order'
'404':
$ref: '#/components/responses/NotFound'
delete:
operationId: deleteOrder
summary: Delete an order
tags: [Orders]
parameters:
- $ref: '#/components/parameters/OrderId'
responses:
'204':
description: Order deleted
components:
parameters:
OrderId:
name: id
in: path
required: true
schema:
type: string
format: uuid
schemas:
Order:
type: object
properties:
id:
type: string
format: uuid
customerEmail:
type: string
format: email
status:
type: string
enum: [PENDING, CONFIRMED, SHIPPED, DELIVERED, CANCELLED]
items:
type: array
items:
$ref: '#/components/schemas/OrderItem'
createdAt:
type: string
format: date-time
OrderItem:
type: object
properties:
productId:
type: string
format: uuid
productName:
type: string
quantity:
type: integer
minimum: 1
unitPrice:
type: number
format: double
CreateOrderRequest:
type: object
required: [customerEmail, items]
properties:
customerEmail:
type: string
format: email
items:
type: array
minItems: 1
items:
type: object
required: [productId, quantity]
properties:
productId:
type: string
format: uuid
quantity:
type: integer
minimum: 1
PageOrder:
type: object
properties:
content:
type: array
items:
$ref: '#/components/schemas/Order'
totalElements:
type: integer
format: int64
totalPages:
type: integer
ProblemDetail:
type: object
properties:
type:
type: string
format: uri
title:
type: string
status:
type: integer
detail:
type: string
instance:
type: string
format: uri
responses:
NotFound:
description: Resource not found
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetail'
ValidationError:
description: Validation failed
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetail'
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |