openapi

Generate, extend, and implement OpenAPI 3.x specifications for RESTful APIs.

1|Updated Mar 1, 2026
One-click install
npx skills add https://github.com/mgoericke/claude-skills-devcontainer --skill openapi-mgoericke
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openapi
Source: https://github.com/mgoericke/claude-skills-devcontainer/tree/main/.claude/skills/openapi
Command: npx skills add https://github.com/mgoericke/claude-skills-devcontainer --skill openapi-mgoericke

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the entire API lifecycle, from initial design and specification to code generation, ensuring consistency and reducing development time.

Core Features & Use Cases

  • API Specification Creation: Design new APIs from scratch through an interactive interview process.
  • API Specification Extension: Seamlessly add new endpoints and schemas to existing OpenAPI definitions.
  • Code Generation: Automatically generate Java DTOs, REST controllers (Spring Boot), or Resources (Quarkus) from OpenAPI specifications.
  • Use Case: You need to define a new REST API for a user management service. Use this Skill to create the OpenAPI specification, then generate the initial Java code structure for your backend.

Quick Start

Create a new API spec for an order service.

Frequently Asked Questions about openapi

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

FAQPage Schema
How do I generate Java code from an OpenAPI specification?

To generate Java code from an OpenAPI specification, you can use this Skill to automatically scaffold Java DTOs, Spring Boot REST controllers, or Quarkus Resources based on your provided OpenAPI 3.x definitions. It automates backend code scaffolding directly from your API specs.

What is the best way to design a new REST API specification from scratch?

The best way to design a new REST API specification from scratch is using an API design-first workflow. This Skill facilitates this by guiding you through an interactive interview process to create OpenAPI 3.x specifications for new RESTful APIs.

Can I add new endpoints and schemas to an existing OpenAPI definition?

Yes, you can extend existing OpenAPI definitions by adding new endpoints and schemas. This Skill supports API specification extension, allowing you to seamlessly add new paths and data schemas to your current OpenAPI 3.x files.

Does this OpenAPI generator work with both Spring Boot and Quarkus?

Yes, this OpenAPI generator works with both Spring Boot and Quarkus. It can automatically generate Java DTOs and corresponding REST controllers for Spring Boot or Resources specifically tailored for Quarkus from your OpenAPI specifications.

How do I create an OpenAPI specification for a user management service?

To create an OpenAPI specification for a user management service, you initiate a new API specification creation task. This Skill streamlines the API lifecycle by interactively helping you define the REST API and then generating the initial Java backend code structure.

When should I use an API design-first workflow for RESTful APIs?

You should use an API design-first workflow for RESTful APIs when you need to ensure consistency and reduce development time across the entire API lifecycle. It allows you to define the OpenAPI specification before implementing the backend Java code.