openapi-validatorlisted
Install: claude install-skill a5c-ai/babysitter
# OpenAPI Validator Skill
## Overview
Validates OpenAPI specifications for correctness, security definitions, best practices compliance, and breaking change detection between versions.
## Capabilities
- Validate OpenAPI 3.0/3.1 specifications
- Check security definitions completeness
- Lint for API design best practices
- Compare specification versions
- Detect breaking changes between versions
- Custom rule configuration
- Integration with Spectral and other linters
## Target Processes
- api-design-specification
- system-design-review
## Input Schema
```json
{
"type": "object",
"required": ["specPath"],
"properties": {
"specPath": {
"type": "string",
"description": "Path to OpenAPI specification file"
},
"mode": {
"type": "string",
"enum": ["validate", "lint", "compare", "security"],
"default": "validate"
},
"compareWith": {
"type": "string",
"description": "Path to previous spec version for comparison"
},
"rules": {
"type": "object",
"properties": {
"ruleset": {
"type": "string",
"enum": ["spectral:oas", "custom"],
"default": "spectral:oas"
},
"severity": {
"type": "string",
"enum": ["error", "warn", "info"],
"default": "warn"
}
}
}
}
}
```
## Output Schema
```json
{
"type": "object",
"properties": {
"valid": {
"type": "boolean"
},
"errors": {
"typ