Can I apply multiple overlays to one specification?

Yes, you can apply multiple overlays in a sequence. Overlays applied later in the order will override changes made by earlier ones.

How does this skill help with SDK generation?

It allows you to clean up or enhance your API spec—such as renaming parameters or adding tags—specifically to improve the quality of SDKs generated by Speakeasy.

What is an OpenAPI overlay?

An OpenAPI overlay is a separate file that defines modifications or additions to an existing OpenAPI document without changing the primary source file.

Does this skill require the Speakeasy CLI?

Yes, this skill generates and executes commands for the Speakeasy CLI to perform the actual overlay application.

OpenAPI Overlay Management

Name: OpenAPI Overlay Management
Author: speakeasy-api

byspeakeasy-api

•

378

API Development

Applies OpenAPI overlays to transform and refine API specifications without modifying the source files directly.

About

The apply-openapi-overlay skill empowers developers to programmatically modify OpenAPI specifications using Speakeasy's overlay system. This is essential for refining API definitions for SDK generation, adding documentation metadata, or reorganizing operations for better developer experience. By utilizing this skill, Claude can automate the application of multiple overlay files in a specific order, ensuring that your API contracts remain clean while your generated outputs—like SDKs and documentation—are perfectly tailored to your needs.

Key Features

Support for sequential overlay merging to override previous changes
378 GitHub stars
Programmatically apply overlay files to existing OpenAPI specs
Safe modification of API paths, operations, and metadata
Automated CLI command generation for spec transformations
Seamless integration with Speakeasy workflow configurations

Use Cases

Managing environment-specific API configuration changes
Adding custom documentation or grouping metadata to generated specs
Refining OpenAPI specs for production-grade SDK generation

About

Key Features

Support for sequential overlay merging to override previous changes
378 GitHub stars
Programmatically apply overlay files to existing OpenAPI specs
Safe modification of API paths, operations, and metadata
Automated CLI command generation for spec transformations
Seamless integration with Speakeasy workflow configurations

Use Cases

Managing environment-specific API configuration changes
Adding custom documentation or grouping metadata to generated specs
Refining OpenAPI specs for production-grade SDK generation