Skill Detail

Bundle and validate OpenAPI files into one publishable spec with swagger-cli

Resolve multi-file OpenAPI definitions into one validated artifact before docs, code generation, or CI gates depend on the spec.

Library & API ReferenceMulti-Framework
Library & API Reference Multi-Framework Security Reviewed
⭐ 517 GitHub stars ⬇ 164k/wk npm
INSTALL WITH ANY AGENT
npx skills add agentskillexchange/skills --skill bundle-and-validate-openapi-files-into-one-publishable-spec-with-swagger-cli Copy
Works best when you want a reusable capability, not another fragile one-off prompt.
At a glance
Tools required
Node.js, npm or npx, and one or more Swagger/OpenAPI JSON or YAML files with local or remote $ref targets as needed
Install & setup
Install swagger-cli from npm or invoke it with npx, then run its validate or bundle commands against the root OpenAPI file to produce a single resolved artifact or CI validation result.
Author
APIDevTools
Publisher
Organization
Last updated
Apr 24, 2026
Quick brief

Use swagger-cli when an agent needs to take a split OpenAPI definition, follow its references, and emit a single validated artifact for downstream publishing or checks. Invoke this instead of using a general API platform when the job is specifically spec bundling and validation in a local or CI workflow. The scope boundary is tight: combine referenced OpenAPI files and fail fast on invalid contracts, not run API servers, manage docs portals, or act as a general SDK/framework listing. Note that the upstream project is deprecated, so this is publishable but less future-proof than more actively maintained alternatives.