OpenAPI Overlay Creator
Generates and manages OpenAPI overlays to customize SDK generation without modifying the original API specification.
The OpenAPI Overlay Creator skill empowers developers to refine and enhance their API documentation for SDK generation using Speakeasy. By creating portable overlay files, you can rename operations, group endpoints, and add SDK-specific extensions like retry logic or deprecation notices without altering the source OpenAPI file. This is particularly useful when working with third-party APIs or when maintaining a clean separation between the core API contract and SDK-specific presentation layers, ensuring your generated client libraries are idiomatic and user-friendly.
主な機能
01378 GitHub stars
02Create overlay templates from existing OpenAPI specifications
03Customize operation names and group endpoints for cleaner SDK method signatures
04Apply portable patches that work across different versions of a source specification
05Add SDK-specific configurations like retry logic and deprecation tags non-destructively
06Target specific endpoints and schemas using precise JSONPath syntax
ユースケース
01Refining a third-party API spec for better client-side method naming without ownership of the source
02Adding descriptions and grouping to a generated spec to improve SDK discoverability
03Marking specific endpoints as deprecated for SDK users without affecting the underlying API service