Bundle And Validate Openapi Files Into One Publishable Spec With Swagger Cli

Name: Bundle And Validate Openapi Files Into One Publishable Spec With Swagger Cli
Author: agentskillexchange

ASecurity

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

36 stars
0 votes
0 copies
1 view
Added June 8, 2026

ai-agentspythongobashnodegitapisecuritydocumentation

Works with

Security analysis

A92/100

mediumInstalls packages at runtime which could introduce malicious dependencies

Pro shows the line behind each finding and how to fix it

Scanned June 8, 2026

npx -y skills add agentskillexchange/skills --skill bundle-and-validate-openapi-files-into-one-publishable-spec-with-swagger-cli --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Bundle And Validate Openapi Files Into One Publishable Spec With Swagger Cli?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Bundle And Validate Openapi Files Into One Publishable Spec With Swagger Cli

[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/agentskillexchange-bundle-and-validate-openapi-files-into-one-publish/badge)](https://www.skillsdirectory.com/skills/agentskillexchange-bundle-and-validate-openapi-files-into-one-publish)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro

SKILL.md

---
name: "Bundle and validate OpenAPI files into one publishable spec with swagger-cli"
slug: "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."
github_stars: 517
verification: "security_reviewed"
source: "https://github.com/APIDevTools/swagger-cli"
author: "APIDevTools"
publisher_type: "organization"
category: "Library & API Reference"
framework: "Multi-Framework"
tool_ecosystem:
  github_repo: "APIDevTools/swagger-cli"
  github_stars: 517
  npm_package: "swagger-cli"
  npm_weekly_downloads: 163977
---

# 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.

## Prerequisites

Node.js, npm or npx, and one or more Swagger/OpenAPI JSON or YAML files with local or remote $ref targets as needed

## Installation

Use the upstream install or setup path that matches your environment:
- npm install -g @apidevtools/swagger-cli
- git clone https://github.com/APIDevTools/swagger-cli.git
- npm install
- npm test

Requirements and caveats from upstream:
- 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...

Basic usage or getting-started notes:
- --------------------------
- bash
- swagger-cli <command> [options] <file>

- Source: https://github.com/APIDevTools/swagger-cli
- Extracted from upstream docs: https://raw.githubusercontent.com/APIDevTools/swagger-cli/HEAD/README.md

## Documentation

- https://github.com/APIDevTools/swagger-cli

## Source

- [Agent Skill Exchange](https://agentskillexchange.com/skills/bundle-and-validate-openapi-files-into-one-publishable-spec-with-swagger-cli/)