Can I merge more than two files at once?

Yes, the skill supports merging two or more individual files, and you can also use glob patterns to merge all specs within a directory.

Do I need the Speakeasy CLI installed?

Yes, this skill functions as an interface for the Speakeasy CLI 'merge' command to perform the actual file processing.

What is the merge-openapi-specs skill for?

It allows Claude to combine multiple OpenAPI or Swagger specification files into a single output file using Speakeasy's CLI tools.

Does this work with both YAML and JSON files?

Yes, Speakeasy is OpenAPI native and can process and output specifications in both YAML and JSON formats.

How are conflicts handled during the merge process?

When specs have conflicting paths, later specs in the command sequence typically override earlier ones. It is recommended to review the merged output for schema-level conflicts.

OpenAPI Spec Merger

Name: OpenAPI Spec Merger
Author: speakeasy-api

byspeakeasy-api

•

378

API開発

Combines multiple OpenAPI specifications into a single, unified document using the Speakeasy CLI.

概要

This skill streamlines API management by allowing developers to consolidate fragmented OpenAPI or Swagger files into a single source of truth. It is particularly useful for teams working with microservices, where each service maintains its own spec, or for organizations needing to merge internal and public API definitions. By leveraging the Speakeasy merge command, it automates the integration of paths and schemas, simplifying the generation of unified documentation and SDKs.

主な機能

Intelligent conflict resolution via override logic
Wildcard support for directory-wide spec discovery
378 GitHub stars
Unified OpenAPI document generation
Support for merging multiple spec files via CLI
Compatible with YAML and JSON OpenAPI formats

ユースケース

Consolidating microservice APIs into a single gateway specification
Merging internal and external API definitions for public documentation
Combining multiple versioned spec files into a master API reference

概要

主な機能

Intelligent conflict resolution via override logic
Wildcard support for directory-wide spec discovery
378 GitHub stars
Unified OpenAPI document generation
Support for merging multiple spec files via CLI
Compatible with YAML and JSON OpenAPI formats

ユースケース

Consolidating microservice APIs into a single gateway specification
Merging internal and external API definitions for public documentation
Combining multiple versioned spec files into a master API reference