openapilisted

# OpenAPI Skill Creates, extends, and implements OpenAPI 3.x specifications. Supports three modes: **create** spec (from scratch), **extend** spec (add to existing spec), and **generate code** (Java classes in BCE pattern from a spec). > **Philosophy:** The OpenAPI spec is the contract. Whether it's being created, extended, or > implemented – the contract is at the center. Design first, then build. --- ## What This Skill Does 1. **Detects the mode** – Create spec, extend spec, or generate code 2. **Creates OpenAPI specs** – Via structured interview: data models, endpoints, auth 3. **Extends existing specs** – Reads existing spec, adds new paths/schemas 4. **Generates code from specs** – DTOs, REST endpoints, and service stubs in BCE pattern ## How to Use ``` Create a new API spec for an order service ``` ``` Extend the API in api/orders.yaml with a product endpoint ``` ``` Generate code from the OpenAPI spec in api/openapi.yaml ``` ``` Define a REST API for orders and products ``` --- ## Instructions > **Before every execution**: > 1. Check `.claude/lessons-learned.md` ### Step 0 – Detect Mode The three modes (create, extend, generate code) lead to completely different workflows. Clarify the mode first with `AskUserQuestion` so no unnecessary work is done. ``` What would you like to do? ``` Options: - **Create new spec** – Design a new OpenAPI spec from scratch - **Extend existing spec** – Add new endpoints or schemas to an existing spec - **Generate code fro