Openapi Spec Validator Agent

---
name: "OpenAPI Spec Validator"
slug: "openapi-spec-validator-agent"
description: "Validates and lints OpenAPI 3.0/3.1 specifications using Spectral CLI rules and the Swagger Parser library. Detects breaking changes between spec versions and generates migration guides."
github_stars: 3084
verification: "security_reviewed"
source: "https://github.com/stoplightio/spectral"
author: "Stoplight"
category: "Developer Tools"
framework: "Custom Agents"
tool_ecosystem:
  github_repo: "stoplightio/spectral"
  github_stars: 3084
  npm_package: "@stoplight/spectral-cli"
  npm_weekly_downloads: 1165411
---

# OpenAPI Spec Validator

Validates and lints OpenAPI 3.0/3.1 specifications using Spectral CLI rules and the Swagger Parser library. Detects breaking changes between spec versions and generates migration guides.

## Prerequisites

Node.js

## Installation

Use the upstream install or setup path that matches your environment:
- npm install -g @stoplight/spectral-cli
- yarn global add @stoplight/spectral-cli

Basic usage or getting-started notes:
- [💻 Usage](#-usage)
- ## 💻 Usage
- To get started, run this command in your terminal to create a .spectral.yaml file that uses the Spectral predefined rulesets based on OpenAPI, Arazzo or AsyncAPI:

- Source: https://github.com/stoplightio/spectral
- Extracted from upstream docs: https://raw.githubusercontent.com/stoplightio/spectral/HEAD/README.md

## Documentation

- https://docs.stoplight.io/docs/spectral/ZG9jOjExNw-overview

## Source

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