openapi-swagger

# OpenAPI/Swagger Skill Expert skill for OpenAPI/Swagger specification analysis and documentation generation. ## Capabilities - Parse and validate OpenAPI 3.x and Swagger 2.0 specifications - Generate API documentation from specs (ReDoc, Swagger UI) - Detect breaking changes between API versions - Validate request/response examples against schemas - Generate code samples in multiple languages - Lint OpenAPI specs for best practices (Spectral rules) - Convert between OpenAPI formats (YAML/JSON, version migration) ## Usage Invoke this skill when you need to: - Validate and lint OpenAPI specifications - Generate API reference documentation - Detect breaking changes between API versions - Create code samples from API specs - Migrate between OpenAPI versions ## Inputs | Parameter | Type | Required | Description | |-----------|------|----------|-------------| | specPath | string | Yes | Path to OpenAPI/Swagger spec file | | action | string | Yes | validate, lint, generate-docs, diff, generate-samples | | outputDir | string | No | Output directory for generated content | | targetVersion | string | No | Target OpenAPI version for migration | | languages | array | No | Languages for code sample generation | | rulesets | array | No | Spectral ruleset files to apply | ### Input Example ```json { "specPath": "./api/openapi.yaml", "action": "lint", "rulesets": [".spectral.yaml"], "outputDir": "docs/api" } ``` ## Output Structure ### Validation Output ```json { "valid...