# Lint Openapi

> Use this skill when the user wants to lint OpenAPI/Swagger specifications for consistency and standards compliance.

- Skill: `javimosch/lint-openapi` (Agent Skill)
- Install (CLI): `npx skillmds@latest add javimosch/lint-openapi`
- Raw SKILL.md: https://api.skillmd.com/api/skills/javimosch/lint-openapi/raw
- Safety review: PASS (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: javimosch (https://skillmd.com/u/javimosch)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/javimosch/lint-openapi

---


# lint-openapi Plugin

lint-openapi validates OpenAPI specs.

## Usage Examples

- "lint an OpenAPI specification file"
- "check API docs for broken references"
- "validate against OpenAPI 3.1 standards"

## Installation

```bash
npm install -g lint-openapi
```

## Key Features
- OpenAPI 2.0/3.0/3.1 validation
- Swagger specification linting
- Configurable rulesets
- Reference consistency checking
- JSON/YAML output for CI

