improve-sdk-naming

SKILL.md

Improve SDK method naming using AI-powered suggestions or manual overrides. Covers both automatic speakeasy suggest commands and manual naming with x-speakeasy-group and x-speakeasy-name-override extensions.

| OpenAPI spec | Yes | Path to the spec file (-s) | | Authentication | Yes | Via speakeasy auth login or SPEAKEASYAPIKEY env var | | Output file | No | Path for overlay output (-o) |

| Suggestions | Better operation names or error types printed to console | | Overlay file | Optional: saves suggestions as an overlay YAML file (-o) |

Use when SDK methods have ugly auto-generated names or you want AI-powered naming and error type suggestions. Triggers on "suggest improvements", "improve my spec", "speakeasy suggest", "better operation names", "ugly method names", "GetApiV1Users", "improve operation IDs", "sdk.users.list() style", "better SDK naming", "x-speakeasy-group", "suggest error types", "AI suggestions" Source: speakeasy-api/agent-skills.

View raw