{"id":"58081cb8-d6fb-4071-8159-0410a93f10ed","shortId":"KqYejz","kind":"skill","title":"OpenAPI Spec Validator & Linter","tagline":"Validates OpenAPI 3.0/3.1 specifications using the @readme/openapi-parser and Spectral linter with custom rulesets. Detects missing descriptions, inconsistent naming conventions, and security scheme gaps in your API definitions.","description":"# OpenAPI Spec Validator & Linter\n\nValidates OpenAPI 3.0/3.1 specifications using the @readme/openapi-parser and Spectral linter with custom rulesets. Detects missing descriptions, inconsistent naming conventions, and security scheme gaps in your API definitions.\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-linter-2/)","tags":["openapi","spec","validator","linter","skills","agentskillexchange","agent-skills","ai-agents","ai-tools","awesome-list","claude-code","codex"],"capabilities":["skill","source-agentskillexchange","skill-openapi-spec-validator-linter-2","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-linter-2","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 (1,017 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.684Z","embedding":null,"createdAt":"2026-05-18T13:18:06.808Z","updatedAt":"2026-05-18T19:11:33.684Z","lastSeenAt":"2026-05-18T19:11:33.684Z","tsv":"'/3.1':8,40 '/docs/spectral/zg9jojexnw-overview':135 '/skills/openapi-spec-validator-linter-2/)':142 '/stoplightio/spectral':124 '/stoplightio/spectral/head/readme.md':131 '3.0':7,39 'add':83 'agent':137 'agentskillexchange.com':141 'agentskillexchange.com/skills/openapi-spec-validator-linter-2/)':140 'api':31,63 'arazzo':118 'asyncapi':120 'base':115 'basic':85 'command':100 'convent':24,56 'creat':105 'custom':17,49 'definit':32,64 'descript':21,53 'detect':19,51 'doc':128 'docs.stoplight.io':134 'docs.stoplight.io/docs/spectral/zg9jojexnw-overview':133 'document':132 'environ':76 'exchang':139 'extract':125 'file':108 'g':79 'gap':28,60 'get':89,96 'getting-start':88 'github.com':123 'github.com/stoplightio/spectral':122 'global':82 'inconsist':22,54 'instal':65,69,78 'linter':4,15,36,47 'match':74 'miss':20,52 'name':23,55 'note':91 'npm':77 'openapi':1,6,33,38,117 'path':72 'predefin':113 'raw.githubusercontent.com':130 'raw.githubusercontent.com/stoplightio/spectral/head/readme.md':129 'readme/openapi-parser':12,44 'ruleset':18,50,114 'run':98 'scheme':27,59 'secur':26,58 'setup':71 'skill':138 'skill-openapi-spec-validator-linter-2' 'sourc':121,136 'source-agentskillexchange' 'spec':2,34 'specif':9,41 'spectral':14,46,112 'spectral.yaml':107 'start':90,97 'stoplight/spectral-cli':80,84 'termin':103 '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':68,127 'usag':86,92,93,94 'use':10,42,66,110 'valid':3,5,35,37 'yarn':81","prices":[{"id":"adde30e0-6593-40df-8f7d-f3a5fa5fd902","listingId":"58081cb8-d6fb-4071-8159-0410a93f10ed","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.808Z"}],"sources":[{"listingId":"58081cb8-d6fb-4071-8159-0410a93f10ed","source":"github","sourceId":"agentskillexchange/skills/openapi-spec-validator-linter-2","sourceUrl":"https://github.com/agentskillexchange/skills/tree/main/skills/openapi-spec-validator-linter-2","isPrimary":false,"firstSeenAt":"2026-05-18T13:18:06.808Z","lastSeenAt":"2026-05-18T19:11:33.684Z"}],"details":{"listingId":"58081cb8-d6fb-4071-8159-0410a93f10ed","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"agentskillexchange","slug":"openapi-spec-validator-linter-2","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":"e2dc5e8d14231b07578e4d8869774d263be868fd","skill_md_path":"skills/openapi-spec-validator-linter-2/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/agentskillexchange/skills/tree/main/skills/openapi-spec-validator-linter-2"},"layout":"multi","source":"github","category":"skills","frontmatter":{"name":"OpenAPI Spec Validator & Linter","description":"Validates OpenAPI 3.0/3.1 specifications using the @readme/openapi-parser and Spectral linter with custom rulesets. Detects missing descriptions, inconsistent naming conventions, and security scheme gaps in your API definitions."},"skills_sh_url":"https://skills.sh/agentskillexchange/skills/openapi-spec-validator-linter-2"},"updatedAt":"2026-05-18T19:11:33.684Z"}}