Генерация OpenAPI-спецификаций по стандарту Zalando

★ 6.7 · vibe-coding

api-spec-openapi is a Claude Code skill that generates and validates OpenAPI 3.1 specifications following the Zalando RESTful API Guidelines: kebab-case paths, cursor-based pagination, RFC 9457 problem+json error responses, URL versioning, and Idempotency-Key headers for POST operations. Each bounded context is produced as a standalone YAML file named `<bounded-context>.openapi.yaml` inside an `api-specs/` folder, ready for independent publication to SmartBear SwaggerHub. The skill covers the full API contract lifecycle — authoring specs from domain models, updating existing OpenAPI files to align with Zalando conventions, and reviewing them for naming, pagination, error handling, versioning, and security compliance. It is designed for teams building microservice APIs who need a consistent, enforceable standard without manually cross-checking every guideline.