{"id":"8ba64f63-ada3-4ad1-a132-b64998763852","shortId":"8sMCEZ","kind":"skill","title":"OpenAPI Spec Validator & Docs Generator","tagline":"Validates OpenAPI 3.0/3.1 specifications using Spectral linting rules and generates interactive API documentation with Redoc and Swagger UI. Supports custom ruleset definitions and CI integration.","description":"# OpenAPI Spec Validator & Docs Generator\n\nValidates OpenAPI 3.0/3.1 specifications using Spectral linting rules and generates interactive API documentation with Redoc and Swagger UI. Supports custom ruleset definitions and CI integration.\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-docs-generator/)","tags":["openapi","spec","validator","docs","generator","skills","agentskillexchange","agent-skills","ai-agents","ai-tools","awesome-list","claude-code"],"capabilities":["skill","source-agentskillexchange","skill-openapi-spec-validator-docs-generator","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-docs-generator","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 (999 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.582Z","embedding":null,"createdAt":"2026-05-18T13:18:06.707Z","updatedAt":"2026-05-18T19:11:33.582Z","lastSeenAt":"2026-05-18T19:11:33.582Z","tsv":"'/3.1':9,40 '/docs/spectral/zg9jojexnw-overview':133 '/skills/openapi-spec-validator-docs-generator/)':140 '/stoplightio/spectral':122 '/stoplightio/spectral/head/readme.md':129 '3.0':8,39 'add':81 'agent':135 'agentskillexchange.com':139 'agentskillexchange.com/skills/openapi-spec-validator-docs-generator/)':138 'api':18,49 'arazzo':116 'asyncapi':118 'base':113 'basic':83 'ci':30,61 'command':98 'creat':103 'custom':26,57 'definit':28,59 'doc':4,35,126 'docs.stoplight.io':132 'docs.stoplight.io/docs/spectral/zg9jojexnw-overview':131 'document':19,50,130 'environ':74 'exchang':137 'extract':123 'file':106 'g':77 'generat':5,16,36,47 'get':87,94 'getting-start':86 'github.com':121 'github.com/stoplightio/spectral':120 'global':80 'instal':63,67,76 'integr':31,62 'interact':17,48 'lint':13,44 'match':72 'note':89 'npm':75 'openapi':1,7,32,38,115 'path':70 'predefin':111 'raw.githubusercontent.com':128 'raw.githubusercontent.com/stoplightio/spectral/head/readme.md':127 'redoc':21,52 'rule':14,45 'ruleset':27,58,112 'run':96 'setup':69 'skill':136 'skill-openapi-spec-validator-docs-generator' 'sourc':119,134 'source-agentskillexchange' 'spec':2,33 'specif':10,41 'spectral':12,43,110 'spectral.yaml':105 'start':88,95 'stoplight/spectral-cli':78,82 'support':25,56 'swagger':23,54 'termin':101 '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' 'ui':24,55 'upstream':66,125 'usag':84,90,91,92 'use':11,42,64,108 'valid':3,6,34,37 'yarn':79","prices":[{"id":"4f615b3a-2f97-422a-b7e9-b0f5510b25cf","listingId":"8ba64f63-ada3-4ad1-a132-b64998763852","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.707Z"}],"sources":[{"listingId":"8ba64f63-ada3-4ad1-a132-b64998763852","source":"github","sourceId":"agentskillexchange/skills/openapi-spec-validator-docs-generator","sourceUrl":"https://github.com/agentskillexchange/skills/tree/main/skills/openapi-spec-validator-docs-generator","isPrimary":false,"firstSeenAt":"2026-05-18T13:18:06.707Z","lastSeenAt":"2026-05-18T19:11:33.582Z"}],"details":{"listingId":"8ba64f63-ada3-4ad1-a132-b64998763852","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"agentskillexchange","slug":"openapi-spec-validator-docs-generator","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":"d45502e34498d7c5194b1472b600db40be79596a","skill_md_path":"skills/openapi-spec-validator-docs-generator/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/agentskillexchange/skills/tree/main/skills/openapi-spec-validator-docs-generator"},"layout":"multi","source":"github","category":"skills","frontmatter":{"name":"OpenAPI Spec Validator & Docs Generator","description":"Validates OpenAPI 3.0/3.1 specifications using Spectral linting rules and generates interactive API documentation with Redoc and Swagger UI. Supports custom ruleset definitions and CI integration."},"skills_sh_url":"https://skills.sh/agentskillexchange/skills/openapi-spec-validator-docs-generator"},"updatedAt":"2026-05-18T19:11:33.582Z"}}