Skills
.Work. You
Rest

manage-openapi-overlays

Official

Apply precise OpenAPI overlays for SDKs.

Software Engineering#workflow#validation#OpenAPI#overlay#SDK-generation#JSONPath#x-speakeasy
Authorspeakeasy-api
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Overlays let you customize an OpenAPI spec for SDK generation without modifying the source. This enables safer experimentation, faster iteration, and targeted fixes.

Core Features & Use Cases

  • Create, apply, and validate overlay files to fix validation issues, add x-speakeasy extensions, and tune generated SDK behavior.
  • Use in workflows by including overlays in .speakeasy/workflow.yaml, allowing automated, layered customizations.
  • Compare specs to generate overlays, apply overlays to openapi.yaml, and lint overlays for correctness.

Quick Start

Create an overlay and apply it to your spec using the CLI: speakeasy overlay apply -s openapi.yaml -o overlay.yaml --out openapi-modified.yaml

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: manage-openapi-overlays
Download link: https://github.com/speakeasy-api/skills/archive/main.zip#manage-openapi-overlays

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.