Does this skill support custom retry configurations?

Yes, it provides guidance and implementation patterns for adding 'x-speakeasy-retries' to your operations, allowing you to define backoff strategies and status code triggers.

How do I create an overlay from a modified spec file?

Use the 'speakeasy overlay compare' command included in this skill to compare your original spec with a modified version; it will automatically generate the corresponding overlay file.

What is an OpenAPI overlay?

An OpenAPI overlay is a standalone document that describes modifications to an OpenAPI specification without altering the original source file. It uses JSONPath to target specific nodes and apply updates or removals.

How do I fix SDK naming issues with this skill?

You can use the 'x-speakeasy-name-override' extension within an overlay file to target specific operations and provide a more user-friendly method name for your generated SDK.

Can I apply overlays automatically in my CI/CD?

Yes, by adding your overlay files to the 'sources.overlays' section of your Speakeasy workflow.yaml, they will be applied automatically whenever you run 'speakeasy run'.

OpenAPI Overlay Manager

Name: OpenAPI Overlay Manager
Author: speakeasy-api

byspeakeasy-api

•

API開発

Customizes OpenAPI specifications for SDK generation using JSONPath-targeted overlays without modifying the source file.

The manage-openapi-overlays skill enables developers to refine and enhance OpenAPI specifications through overlays, allowing for the addition of Speakeasy extensions like custom retries, pagination, and method grouping. It is particularly useful for fixing linting errors, overriding SDK naming conventions, and applying metadata to externally managed specs, ensuring that generated SDKs are production-ready while keeping the original API definition untouched. By using JSONPath expressions, it provides a precise and non-destructive way to transform API definitions into high-quality client libraries.

主な機能

01JSONPath-based targeting for precise specification modifications

02Speakeasy extension support for retries, pagination, and naming overrides

03Automated overlay generation via spec comparison (compare before/after)

04Configuration of complex security schemes and global header parameters

05Overlay validation to ensure correct syntax and action structure

065 GitHub stars

ユースケース

01Fixing OpenAPI validation and linting errors in third-party or externally managed specs

02Customizing SDK method names and logical grouping without changing the underlying API

03Implementing production-grade SDK features like exponential backoff retries and cursor-based pagination

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add speakeasy-api/skills manage-openapi-overlays

For use in Claude.ai and ChatGPT

Download Skill