skills.rest
OmexIT
OmexITCOMMUNITY
Explore all skills by this author →
GitHub

api-first

Generates a complete Spring Boot 4 REST API stack from an OpenAPI fragment.

13|4|Updated Feb 20, 2026
Search Tags:#testing#api#openapi#scaffold#spring-boot#code-generation#mapstruct
One-click install
npx skills add https://github.com/OmexIT/claude-skills-pack --skill api-first
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: api-first
Source: https://github.com/OmexIT/claude-skills-pack/tree/main/skills/api-first
Command: npx skills add https://github.com/OmexIT/claude-skills-pack --skill api-first

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill automates the boilerplate generation for a REST API by turning an OpenAPI 3.1 fragment into a complete Spring Boot 4 endpoint stack, saving developers hours of repetitive wiring.

Core Features & Use Cases

  • Generates a full controller, service, repository, DTOs, MapStruct mappers, validation, exception handling, and an OpenAPI 3.1 spec from a fragment.
  • Produces slice tests, integration tests, and project structure compatible with Testcontainers and modern Spring Boot conventions.
  • Ideal for rapidly adding new resources from an API contract, including CRUD operations and standardized error handling.

Quick Start

Provide an OpenAPI fragment or resource spec and the skill will scaffold the full API stack for Spring Boot 4.

Frequently Asked Questions about api-first

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scaffold a Spring Boot REST API from an OpenAPI spec?▼

To scaffold a Spring Boot REST API from an OpenAPI spec, you provide an OpenAPI 3.1 fragment and the skill generates the full controller, service, repository, DTOs, and MapStruct mappers stack.

What boilerplate does OpenAPI code generation for Spring Boot 4 include?▼

OpenAPI code generation for Spring Boot 4 includes validation, exception handling, RFC 9457 error details, standardized response envelopes, idempotency for POST, and cursor-based pagination.

Can I generate MapStruct mappers and DTOs directly from an OpenAPI fragment?▼

Yes, you can generate MapStruct mappers and DTOs directly from an OpenAPI fragment. The skill automates this boilerplate wiring to map between DTOs and entities seamlessly.

Does the scaffolded Spring Boot API stack include integration and slice tests?▼

Yes, the scaffolded Spring Boot API stack includes integration and slice tests. The generated project structure is compatible with Testcontainers and modern Spring Boot conventions.

What's the best way to add CRUD operations from an API contract in Spring Boot?▼

The best way to add CRUD operations from an API contract in Spring Boot is using this skill to turn the contract into a complete endpoint stack with standardized error handling.

Why use cursor-based pagination and idempotency in a Spring Boot API scaffold?▼

Cursor-based pagination and idempotency are used in the Spring Boot API scaffold to ensure reliable data retrieval and safe POST retries conforming to modern REST standards.

Related Skills

Explore More Software Engineering Skills→
joaquimscostajoaquimscosta
21

spring-boot-testing

Test and migrate Spring Boot 3 code to Spring Boot 4 with standardized workflows.

Community
Advanced
giuseppe-trisciuogliogiuseppe-trisciuoglio
322

unit-test-mapper-converter

Unit test MapStruct DTO-entity mappings and custom converters.

Community
Intermediate
Faouzi91Faouzi91

spring-dto

Generate Spring Boot DTOs, MapStruct mappers, and Jakarta validation annotations.

Community
Intermediate
Allra-FintechAllra-Fintech

allra-api-design

Define backend API structure and DTO naming for Spring Boot applications.

Official
Intermediate