skills.rest
CarlosEGuerraSilva
CarlosEGuerraSilvaCOMMUNITY
Explore all skills by this author →
Website𝕏@carlosedgusiGitHub

improve-sdk-naming

Suggest improved operation IDs and error types for SDK method names.

Updated Feb 28, 2026
Search Tags:#api#code generation#sdk#naming#speakeasy#ai suggestions
One-click install
npx skills add https://github.com/CarlosEGuerraSilva/OpenRouterSDK.NET --skill improve-sdk-naming-carloseguerrasilva
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: improve-sdk-naming
Source: https://github.com/CarlosEGuerraSilva/OpenRouterSDK.NET/tree/main/.agents/skills/improve-sdk-naming
Command: npx skills add https://github.com/CarlosEGuerraSilva/OpenRouterSDK.NET --skill improve-sdk-naming-carloseguerrasilva

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill addresses the issue of poorly named or auto-generated SDK methods, improving the overall clarity and usability of generated SDKs.

Core Features & Use Cases

  • AI-Powered Suggestions: Leverages Speakeasy's AI to suggest better operation IDs and error types.
  • Automated Naming: Integrates with speakeasy suggest for automatic improvements.
  • Use Case: When an SDK has methods like get_api_v1_users_list, this skill helps transform it into a more readable listUsers by suggesting and applying naming conventions.

Quick Start

Use the improve-sdk-naming skill to get AI suggestions for operation IDs in your openapi.yaml file.

Frequently Asked Questions about improve-sdk-naming

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I improve auto-generated SDK method names in my OpenAPI spec?▼

You can improve SDK method names by using AI-powered suggestions to refine operation IDs and error types. This skill leverages Speakeasy's AI to transform unreadable auto-generated names like get_api_v1_users_list into cleaner conventions such as listUsers.

What is the best way to rename operation IDs for better SDK code generation?▼

Renaming operation IDs for SDK code generation is best handled by automated AI suggestions. The skill integrates with the speakeasy suggest command to automatically analyze your openapi.yaml file and apply improved naming conventions.

Do I need to authenticate with Speakeasy to get AI suggestions for SDK naming?▼

Yes, authentication is required to get AI suggestions for SDK naming. You must authenticate either by running the speakeasy auth login command or by setting a Speakeasy API key environment variable before generating suggestions.

Can I automatically fix poorly named SDK methods in my API spec?▼

Yes, you can automatically fix poorly named SDK methods by applying AI-generated suggestions. The skill targets unclear or auto-generated method names in your specification and facilitates applying automated improvements for better overall SDK usability.

Related Skills

Explore More Software Engineering Skills→
berea-chberea-ch

improve-sdk-naming

Suggest improved SDK method names and error types in OpenAPI specifications.

Official
Intermediate
speakeasy-apispeakeasy-api
19

improve-sdk-naming

Generate SDK operation ID suggestions from OpenAPI specs via speakeasy suggest.

Official
Intermediate
berea-chberea-ch

orchestrate-multi-target-sdks

Generate multi-language SDKs from an OpenAPI specification using the Speakeasy CLI.

Official
Advanced
devCharuzudevCharuzu

api-design-reviewer

Lint OpenAPI specs for REST conventions and breaking changes.

Community
Advanced