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.

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

01Support for sequential overlay merging to override previous changes

02378 GitHub stars

03Programmatically apply overlay files to existing OpenAPI specs

04Safe modification of API paths, operations, and metadata

05Automated CLI command generation for spec transformations

06Seamless integration with Speakeasy workflow configurations

Use Cases

01Managing environment-specific API configuration changes

02Adding custom documentation or grouping metadata to generated specs

03Refining OpenAPI specs for production-grade SDK generation

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add speakeasy-api/speakeasy apply-openapi-overlay

For use in Claude.ai and ChatGPT

Download Skill