{"id":"6c7903ef-4b47-40f1-959d-598a32519c08","shortId":"cqysPM","kind":"skill","title":"Bundle and validate OpenAPI files into one publishable spec with swagger-cli","tagline":"Resolve multi-file OpenAPI definitions into one validated artifact before docs, code generation, or CI gates depend on the spec.","description":"# Bundle and validate OpenAPI files into one publishable spec with swagger-cli\n\nResolve multi-file OpenAPI definitions into one validated artifact before docs, code generation, or CI gates depend on the spec.\n\n## Prerequisites\n\nNode.js, npm or npx, and one or more Swagger/OpenAPI JSON or YAML files with local or remote $ref targets as needed\n\n## Installation\n\nUse the upstream install or setup path that matches your environment:\n- npm install -g @apidevtools/swagger-cli\n- git clone https://github.com/APIDevTools/swagger-cli.git\n- npm install\n- npm test\n\nRequirements and caveats from upstream:\n- There is a useful Python tool called [pre-commit](https://pre-commit.com/) that can be used to execute a wide suite of pre-commit checks. The swagger-cli validate command can be integrated as part of a git pre-commit...\n\nBasic usage or getting-started notes:\n- --------------------------\n- bash\n- swagger-cli <command> [options] <file>\n\n- Source: https://github.com/APIDevTools/swagger-cli\n- Extracted from upstream docs: https://raw.githubusercontent.com/APIDevTools/swagger-cli/HEAD/README.md\n\n## Documentation\n\n- https://github.com/APIDevTools/swagger-cli\n\n## Source\n\n- [Agent Skill Exchange](https://agentskillexchange.com/skills/bundle-and-validate-openapi-files-into-one-publishable-spec-with-swagger-cli/)","tags":["bundle","and","validate","openapi","files","into","one","publishable","spec","with","swagger","cli"],"capabilities":["skill","source-agentskillexchange","skill-bundle-and-validate-openapi-files-into-one-publishable-spec-with-swagger-cli","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/bundle-and-validate-openapi-files-into-one-publishable-spec-with-swagger-cli","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,313 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:09:43.514Z","embedding":null,"createdAt":"2026-05-18T13:15:33.099Z","updatedAt":"2026-05-18T19:09:43.514Z","lastSeenAt":"2026-05-18T19:09:43.514Z","tsv":"'/)':133 '/apidevtools/swagger-cli':180,191 '/apidevtools/swagger-cli.git':111 '/apidevtools/swagger-cli/head/readme.md':187 '/skills/bundle-and-validate-openapi-files-into-one-publishable-spec-with-swagger-cli/)':198 'agent':193 'agentskillexchange.com':197 'agentskillexchange.com/skills/bundle-and-validate-openapi-files-into-one-publishable-spec-with-swagger-cli/)':196 'apidevtools/swagger-cli':106 'artifact':23,57 'bash':172 'basic':165 'bundl':1,35 'call':127 'caveat':118 'check':147 'ci':29,63 'cli':13,47,151,175 'clone':108 'code':26,60 'command':153 'commit':130,146,164 'definit':19,53 'depend':31,65 'doc':25,59,184 'document':188 'environ':102 'exchang':195 'execut':139 'extract':181 'file':5,17,39,51,82 'g':105 'gate':30,64 'generat':27,61 'get':169 'getting-start':168 'git':107,161 'github.com':110,179,190 'github.com/apidevtools/swagger-cli':178,189 'github.com/apidevtools/swagger-cli.git':109 'instal':91,95,104,113 'integr':156 'json':79 'local':84 'match':100 'multi':16,50 'multi-fil':15,49 'need':90 'node.js':70 'note':171 'npm':71,103,112,114 'npx':73 'one':7,21,41,55,75 'openapi':4,18,38,52 'option':176 'part':158 'path':98 'pre':129,145,163 'pre-commit':128,144,162 'pre-commit.com':132 'pre-commit.com/)':131 'prerequisit':69 'publish':8,42 'python':125 'raw.githubusercontent.com':186 'raw.githubusercontent.com/apidevtools/swagger-cli/head/readme.md':185 'ref':87 'remot':86 'requir':116 'resolv':14,48 'setup':97 'skill':194 'skill-bundle-and-validate-openapi-files-into-one-publishable-spec-with-swagger-cli' 'sourc':177,192 'source-agentskillexchange' 'spec':9,34,43,68 'start':170 'suit':142 'swagger':12,46,150,174 'swagger-c':11,45,149,173 'swagger/openapi':78 'target':88 'test':115 'tool':126 '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':94,120,183 'usag':166 'use':92,124,137 'valid':3,22,37,56,152 'wide':141 'yaml':81","prices":[{"id":"0fe2afcf-e283-4340-a6ea-b1a07e0a0d0d","listingId":"6c7903ef-4b47-40f1-959d-598a32519c08","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:15:33.099Z"}],"sources":[{"listingId":"6c7903ef-4b47-40f1-959d-598a32519c08","source":"github","sourceId":"agentskillexchange/skills/bundle-and-validate-openapi-files-into-one-publishable-spec-with-swagger-cli","sourceUrl":"https://github.com/agentskillexchange/skills/tree/main/skills/bundle-and-validate-openapi-files-into-one-publishable-spec-with-swagger-cli","isPrimary":false,"firstSeenAt":"2026-05-18T13:15:33.099Z","lastSeenAt":"2026-05-18T19:09:43.514Z"}],"details":{"listingId":"6c7903ef-4b47-40f1-959d-598a32519c08","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"agentskillexchange","slug":"bundle-and-validate-openapi-files-into-one-publishable-spec-with-swagger-cli","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":"9bc2a695900822909fed72d0ba3faa489e6a6fbc","skill_md_path":"skills/bundle-and-validate-openapi-files-into-one-publishable-spec-with-swagger-cli/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/agentskillexchange/skills/tree/main/skills/bundle-and-validate-openapi-files-into-one-publishable-spec-with-swagger-cli"},"layout":"multi","source":"github","category":"skills","frontmatter":{"name":"Bundle and validate OpenAPI files into one publishable spec with swagger-cli","description":"Resolve multi-file OpenAPI definitions into one validated artifact before docs, code generation, or CI gates depend on the spec."},"skills_sh_url":"https://skills.sh/agentskillexchange/skills/bundle-and-validate-openapi-files-into-one-publishable-spec-with-swagger-cli"},"updatedAt":"2026-05-18T19:09:43.514Z"}}