openapi-generatorlisted
Install: claude install-skill claude-dev-suite/claude-dev-suite
# OpenAPI Generator - Quick Reference
## When to Use This Skill
- Generate type-safe API clients from OpenAPI specs
- Generate server stubs from OpenAPI specs
- Maintain sync between API and code
- Multi-language client generation (Java, Python, Go, etc.)
- Spring Boot server generation
> **Deep Knowledge**: Use `mcp__documentation__fetch_docs` with technology: `openapi-generator` for comprehensive documentation.
## CLI Usage
### Install
```bash
npm install @openapitools/openapi-generator-cli -g
# or
brew install openapi-generator
```
### Generate TypeScript Client
```bash
openapi-generator-cli generate \
-i api.yaml \
-g typescript-fetch \
-o ./generated/api \
--additional-properties=supportsES6=true,typescriptThreePlus=true
```
### Generate TypeScript Axios Client
```bash
openapi-generator-cli generate \
-i api.yaml \
-g typescript-axios \
-o ./generated/api
```
### Generate Java Client
```bash
openapi-generator-cli generate \
-i api.yaml \
-g java \
-o ./generated/api \
--additional-properties=library=webclient,dateLibrary=java8
```
### Generate Spring Server
```bash
openapi-generator-cli generate \
-i api.yaml \
-g spring \
-o ./generated/server \
--additional-properties=interfaceOnly=true,useSpringBoot3=true
```
## NPM Script Integration
### package.json
```json
{
"scripts": {
"generate:api": "openapi-generator-cli generate -i ./api/openapi.yaml -g typescript-fetch -o ./src/generated/api"
}
}
```
## Maven Plugin
```xml
<p