# OpenAPI Specification Validator

> Validates and lints OpenAPI 3.x specifications using swagger-parser, spectral, and openapi-typescript. Generates type-safe client SDKs and detects breaking API changes via oasdiff.

- Skill: `agentskillexchange/openapi-specification-validator` (Agent Skill)
- Install (CLI): `npx skillmds@latest add agentskillexchange/openapi-specification-validator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/agentskillexchange/openapi-specification-validator/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: agentskillexchange (https://skillmd.com/u/agentskillexchange)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/agentskillexchange/openapi-specification-validator

---


# OpenAPI Specification Validator

Validates and lints OpenAPI 3.x specifications using swagger-parser, spectral, and openapi-typescript. Generates type-safe client SDKs and detects breaking API changes via oasdiff.

## Prerequisites

swagger-parser, @stoplight/spectral, openapi-typescript, oasdiff, Redocly CLI

## Installation

Use the upstream install or setup path that matches your environment:
- npm install @apidevtools/swagger-parser
- git clone https://github.com/APIDevTools/swagger-parser.git
- npm install
- npm test

Requirements and caveats from upstream:
- **[Tested](https://github.com/APIDevTools/swagger-parser/actions)** in Node.js and all modern web browsers on Mac, Windows, and Linux
- When using Swagger Parser in Node.js apps, you'll probably want to use **CommonJS** syntax:
- const SwaggerParser = require("@apidevtools/swagger-parser");

Basic usage or getting-started notes:
- ## Example
- Or use async/await or [Promise](http://javascriptplayground.com/blog/2015/02/promises/) syntax instead. The following example is the same as above:
- bash

- Source: https://github.com/APIDevTools/swagger-parser
- Extracted from upstream docs: https://raw.githubusercontent.com/APIDevTools/swagger-parser/HEAD/README.md

## Documentation

- https://apidevtools.com/swagger-parser/docs/

## Source

- [Agent Skill Exchange](https://agentskillexchange.com/skills/openapi-specification-validator-agent/)