# Merge Openapi Specs

> Use when combining multiple OpenAPI specs, or have microservices with separate spec files

- Skill: `majiayu000/merge-openapi-specs` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/merge-openapi-specs`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/merge-openapi-specs/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/merge-openapi-specs

---


# merge-openapi-specs

Use `speakeasy merge` to combine multiple specs into one.

## Command

```bash
speakeasy merge -o <output-path> <spec1> <spec2> [spec3...]
```

## Example

```bash
# Merge two specs
speakeasy merge -o combined.yaml ./api/users.yaml ./api/orders.yaml

# Merge multiple specs
speakeasy merge -o combined.yaml ./specs/*.yaml
```

## Use Cases

- Microservices with separate specs per service
- API versioning with multiple spec files
- Combining public and internal API specs

## Conflict Resolution

When specs have conflicts:
- Later specs override earlier ones for duplicate paths
- Schema conflicts may require manual resolution
- Review merged output for correctness