Spectral
The API style-guide linter — validates OpenAPI, AsyncAPI and Arazzo documents against rulesets you write yourself, and emits machine-readable findings with source locations.
Specifications it implements
What this tool does to each specification, in the role vocabulary. Follow a standard through to standards.apievangelist.com for what it actually specifies.
- Interfaces
clilibraryci-action- Install
-
npm
@stoplight/spectral-cli - Invoke
npx @stoplight/spectral-cli lint <spec.yaml> --ruleset <.spectral.yaml> --format json- Consumes
- openapi, asyncapi, arazzo, json, yaml
- Emits
- json, junit, sarif, github-actions, pretty
- Runtime
- Runs offline Deterministic Read-only No credentials
Where it applies
Jobs this tool actually does, and the surface each one is exercised on.
The highest-leverage agent use of any tool here — the output is a structured list of findings with paths and line numbers, so the agent can go fix them rather than summarise them.
- Website
- https://stoplight.io/spectral
- Repository
- https://github.com/stoplightio/spectral
- License
- Apache-2.0 — reported by the GitHub API, verified 2026-09-17
- Stars
- 3206 · last commit 2026-09-17
- Companies hiring
- 31 — distinct companies whose job postings name this tool, Q3-2026. A demand signal, not a deployment count.
/tools.json,
against the tool.schema.json
schema, using the roles.json
vocabulary. Start at /llms.txt.