{"id":"26dd9bca-1821-4a02-b1f4-e7fed3692519","shortId":"CySbvB","kind":"skill","title":"OpenAPI Spec Validator","tagline":"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.","description":"# OpenAPI Spec Validator\n\nValidates 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.\n\n## Prerequisites\n\nNode.js\n\n## Installation\n\nUse the upstream install or setup path that matches your environment:\n- npm install -g @stoplight/spectral-cli\n- yarn global add @stoplight/spectral-cli\n\nBasic usage or getting-started notes:\n- [💻 Usage](#-usage)\n- ## 💻 Usage\n- 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:\n\n- Source: https://github.com/stoplightio/spectral\n- Extracted from upstream docs: https://raw.githubusercontent.com/stoplightio/spectral/HEAD/README.md\n\n## Documentation\n\n- https://docs.stoplight.io/docs/spectral/ZG9jOjExNw-overview\n\n## Source\n\n- [Agent Skill Exchange](https://agentskillexchange.com/skills/openapi-spec-validator-agent/)","tags":["openapi","spec","validator","agent","skills","agentskillexchange","agent-skills","ai-agents","ai-tools","awesome-list","claude-code","codex"],"capabilities":["skill","source-agentskillexchange","skill-openapi-spec-validator-agent","topic-agent-skills","topic-ai-agents","topic-ai-tools","topic-awesome-list","topic-claude-code","topic-codex","topic-cursor","topic-llm","topic-mcp","topic-npx-skills","topic-openclaw","topic-skills-catalog"],"categories":["skills"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/agentskillexchange/skills/openapi-spec-validator-agent","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add agentskillexchange/skills","source_repo":"https://github.com/agentskillexchange/skills","install_from":"skills.sh"}},"qualityScore":"0.454","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 8 github stars · SKILL.md body (990 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:11:33.489Z","embedding":null,"createdAt":"2026-05-18T13:18:06.587Z","updatedAt":"2026-05-18T19:11:33.489Z","lastSeenAt":"2026-05-18T19:11:33.489Z","tsv":"'/3.1':9,38 '/docs/spectral/zg9jojexnw-overview':131 '/skills/openapi-spec-validator-agent/)':138 '/stoplightio/spectral':120 '/stoplightio/spectral/head/readme.md':127 '3.0':8,37 'add':79 'agent':133 'agentskillexchange.com':137 'agentskillexchange.com/skills/openapi-spec-validator-agent/)':136 'arazzo':114 'asyncapi':116 'base':111 'basic':81 'break':21,50 'chang':22,51 'cli':13,42 'command':96 'creat':101 'detect':20,49 'doc':124 'docs.stoplight.io':130 'docs.stoplight.io/docs/spectral/zg9jojexnw-overview':129 'document':128 'environ':72 'exchang':135 'extract':121 'file':104 'g':75 'generat':27,56 'get':85,92 'getting-start':84 'github.com':119 'github.com/stoplightio/spectral':118 'global':78 'guid':29,58 'instal':61,65,74 'librari':19,48 'lint':6,35 'match':70 'migrat':28,57 'node.js':60 'note':87 'npm':73 'openapi':1,7,30,36,113 'parser':18,47 'path':68 'predefin':109 'prerequisit':59 'raw.githubusercontent.com':126 'raw.githubusercontent.com/stoplightio/spectral/head/readme.md':125 'rule':14,43 'ruleset':110 'run':94 'setup':67 'skill':134 'skill-openapi-spec-validator-agent' 'sourc':117,132 'source-agentskillexchange' 'spec':2,24,31,53 'specif':10,39 'spectral':12,41,108 'spectral.yaml':103 'start':86,93 'stoplight/spectral-cli':76,80 'swagger':17,46 'termin':99 'topic-agent-skills' 'topic-ai-agents' 'topic-ai-tools' 'topic-awesome-list' 'topic-claude-code' 'topic-codex' 'topic-cursor' 'topic-llm' 'topic-mcp' 'topic-npx-skills' 'topic-openclaw' 'topic-skills-catalog' 'upstream':64,123 'usag':82,88,89,90 'use':11,40,62,106 'valid':3,4,32,33 'version':25,54 'yarn':77","prices":[{"id":"4cc51cb3-cd98-4348-ab3d-cab463eeaf87","listingId":"26dd9bca-1821-4a02-b1f4-e7fed3692519","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"agentskillexchange","category":"skills","install_from":"skills.sh"},"createdAt":"2026-05-18T13:18:06.587Z"}],"sources":[{"listingId":"26dd9bca-1821-4a02-b1f4-e7fed3692519","source":"github","sourceId":"agentskillexchange/skills/openapi-spec-validator-agent","sourceUrl":"https://github.com/agentskillexchange/skills/tree/main/skills/openapi-spec-validator-agent","isPrimary":false,"firstSeenAt":"2026-05-18T13:18:06.587Z","lastSeenAt":"2026-05-18T19:11:33.489Z"}],"details":{"listingId":"26dd9bca-1821-4a02-b1f4-e7fed3692519","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"agentskillexchange","slug":"openapi-spec-validator-agent","github":{"repo":"agentskillexchange/skills","stars":8,"topics":["agent-skills","ai-agents","ai-tools","awesome-list","claude-code","codex","cursor","llm","mcp","npx-skills","openclaw","skills-catalog"],"license":"mit","html_url":"https://github.com/agentskillexchange/skills","pushed_at":"2026-05-18T19:02:17Z","description":"The open catalog of AI agent skills — 2,000+ security-scanned skills for Claude Code, Cursor, Codex, and more.","skill_md_sha":"10c87617ee3feab118ca76d60eed112119718b5b","skill_md_path":"skills/openapi-spec-validator-agent/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/agentskillexchange/skills/tree/main/skills/openapi-spec-validator-agent"},"layout":"multi","source":"github","category":"skills","frontmatter":{"name":"OpenAPI Spec Validator","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."},"skills_sh_url":"https://skills.sh/agentskillexchange/skills/openapi-spec-validator-agent"},"updatedAt":"2026-05-18T19:11:33.489Z"}}