# OpenAPI specification (/docs--openapi-gen)

/docs--openapi-gen is a Claude Code skill in the Code section. Scans your code endpoints and generates or updates an OpenAPI 3.0 YAML spec with schemas, security schemes and examples.

- Web version: https://skills.sgomez.dev/en/s/docs--openapi-gen
- Section: [Code](https://skills.sgomez.dev/en/code.md)
- Author: Santiago Gómez de la Torre
- License: MIT
- Source: https://github.com/sgomez-dev/claude-skills/blob/main/skills/docs/openapi-gen.md
- Updated 26 Mar 2026

## How to ask for it

- `/docs--openapi-gen generate the OpenAPI file for my REST API`
- `/docs--openapi-gen update swagger.json with the new endpoints`
- `/docs--openapi-gen I need the OpenAPI spec for this service`

## Install

macOS · Linux:

```
curl -fsSL https://raw.githubusercontent.com/sgomez-dev/claude-skills/main/install.sh | bash
```

Windows:

```
irm https://raw.githubusercontent.com/sgomez-dev/claude-skills/main/install.ps1 | iex
```

Claude Code plugin:

```
/plugin marketplace add sgomez-dev/claude-skills
/plugin install docs-skills@claude-skills-collection
```

## Permissions

- Reads: `**/*`
- Writes: `openapi.yaml`, `swagger.yaml`
- Runs: —
- Network: No
- Destructive: No

## Author's description

Generate or update OpenAPI/Swagger specification from code

- [How we review this](https://skills.sgomez.dev/en/methodology.md)