Openapi validator

Skill a5c-ai/babysitter/library/specializations/software-architecture/skills/openapi-validator

Validate OpenAPI specifications for correctness, security, and best practicesFrom its SKILL.md

Install

npx -y skills add a5c-ai/babysitter --skill openapi-validator

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

SKILL.md

2.6 KB, 566 tokens by cl100k_base, as published. Nobody here has run it

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

{
  "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

{
  "type": "object",
  "properties": {
    "valid": {
      "type": "boolean"
    },
    "errors": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "path": { "type": "string" },
          "message": { "type": "string" },
          "severity": { "type": "string" }
        }
      }
    },
    "warnings": {
      "type": "array"
    },
    "breakingChanges": {
      "type": "array",
      "description": "List of breaking changes when comparing"
    },
    "securityIssues": {
      "type": "array"
    }
  }
}

Usage Example

{
  kind: 'skill',
  skill: {
    name: 'openapi-validator',
    context: {
      specPath: 'api/openapi.yaml',
      mode: 'lint',
      rules: {
        ruleset: 'spectral:oas',
        severity: 'warn'
      }
    }
  }
}

What ships with it: 1 file

379 B alongside SKILL.md

README.md379 B