Speakeasy SDK Method Naming
Optimizes OpenAPI operation IDs to generate clean, idiomatic SDK methods like sdk.users.list() instead of generic endpoints.
The improve-operation-ids skill enhances the ergonomics of Speakeasy-generated SDKs by automating the refinement of OpenAPI operation IDs. It identifies poorly named endpoints and suggests intuitive, grouped naming conventions using x-speakeasy-group and x-speakeasy-name-override extensions. By applying these suggestions via overlays or direct specification updates, developers can ensure their generated client libraries provide a polished, type-safe developer experience that follows industry-standard patterns for resource-based method calls.
Características Principales
01378 GitHub stars
02Seamless integration with the Speakeasy CLI workflow
03Generation of OpenAPI overlays for non-destructive spec improvements
04Automated suggestion of idiomatic operation IDs for OpenAPI specs
05Manual naming overrides for precise SDK method control
06Support for resource grouping using x-speakeasy-group
Casos de Uso
01Organizing flat API structures into logical resource groups like users, orders, and products
02Refactoring legacy OpenAPI specs to produce modern, readable client libraries
03Standardizing method naming conventions across diverse API endpoints