Openapi Spec Linter Docs Generator

Name: Openapi Spec Linter Docs Generator
Author: agentskillexchange

ASecurity

Validates OpenAPI 3.x specifications using Spectral rulesets and generates interactive API documentation with Redoc and Swagger UI. Detects breaking changes using oasdiff for versioned APIs.

36 stars
0 votes
0 copies
2 views
Added June 8, 2026

ai-agentsgogitapisecuritydocumentation

Works with

terminal
cli
api

Security analysis

A92/100

mediumInstalls packages at runtime which could introduce malicious dependencies

Pro shows the line behind each finding and how to fix it

Scanned June 8, 2026

npx -y skills add agentskillexchange/skills --skill openapi-spec-linter-docs-generator --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Openapi Spec Linter Docs Generator?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Openapi Spec Linter Docs Generator

[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/agentskillexchange-openapi-spec-linter-docs-generator/badge)](https://www.skillsdirectory.com/skills/agentskillexchange-openapi-spec-linter-docs-generator)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro

SKILL.md

---
name: "OpenAPI Spec Linter & Docs Generator"
slug: "openapi-spec-linter-docs-generator"
description: "Validates OpenAPI 3.x specifications using Spectral rulesets and generates interactive API documentation with Redoc and Swagger UI. Detects breaking changes using oasdiff for versioned APIs."
github_stars: 3084
verification: "security_reviewed"
source: "https://github.com/stoplightio/spectral"
author: "Stoplight"
category: "Library & API Reference"
framework: "Claude Agents"
tool_ecosystem:
  github_repo: "stoplightio/spectral"
  github_stars: 3084
  npm_package: "@stoplight/spectral-cli"
  npm_weekly_downloads: 1201267
---

# OpenAPI Spec Linter & Docs Generator

Validates OpenAPI 3.x specifications using Spectral rulesets and generates interactive API documentation with Redoc and Swagger UI. Detects breaking changes using oasdiff for versioned APIs.

## 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-linter-docs-generator/)