# Especificación OpenAPI (/docs--openapi-gen)

/docs--openapi-gen es una skill de Claude Code de la sección Código. Escanea los endpoints de tu código y genera o actualiza una especificación OpenAPI 3.0 en YAML con esquemas y autenticación.

- Versión web: https://skills.sgomez.dev/es/s/docs--openapi-gen
- Sección: [Código](https://skills.sgomez.dev/es/code.md)
- Autor: Santiago Gómez de la Torre
- Licencia: MIT
- Código: https://github.com/sgomez-dev/claude-skills/blob/main/skills/docs/openapi-gen.md
- Actualizada el 26 mar 2026

## Cómo pedírselo

- `/docs--openapi-gen genera el archivo OpenAPI de mi API REST`
- `/docs--openapi-gen actualiza el swagger.json con los endpoints nuevos`
- `/docs--openapi-gen necesito la especificación OpenAPI de este servicio`

## Instalar

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
```

Plugin de Claude Code:

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

## Permisos

- Lee: `**/*`
- Escribe: `openapi.yaml`, `swagger.yaml`
- Ejecuta: —
- Red: No
- Destructiva: No

## Descripción del autor (traducida)

Genera o actualiza la especificación OpenAPI/Swagger a partir del código

- [Cómo revisamos esto](https://skills.sgomez.dev/es/methodology.md)