---
title: "OpenAPI Specification Validator"
description: "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."
verification: "security_reviewed"
source: "https://github.com/APIDevTools/swagger-parser"
author: "API Dev Tools"
category:
  - "Library & API Reference"
framework:
  - "Cursor"
tool_ecosystem:
  github_repo: "APIDevTools/swagger-parser"
  github_stars: 1194
  npm_package: "@apidevtools/swagger-parser"
  npm_weekly_downloads: 4282678
---

# 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

Choose whichever fits your setup:

1. Copy this skill folder into your local skills directory.
2. Clone the repo and symlink or copy the skill into your agent workspace.
3. Add the repo as a git submodule if you manage shared skills centrally.
4. Install it through your internal provisioning or packaging workflow.
5. Download the folder directly from GitHub and place it in your skills collection.

Install command or upstream instructions:

```
npm install @apidevtools/swagger-parser
```

## Documentation

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

## Source

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