🎯

improve-sdk-naming

🎯Skill

from speakeasy-api/skills

What it does

Improves SDK method and parameter naming by applying AI-powered recommendations to make method names more readable, consistent, and semantically meaningful.

📦

Part of

speakeasy-api/skills(21 items)

improve-sdk-naming

Installation

Quick InstallInstall with npx

npx skills add speakeasy-api/skills

📖 Extracted from docs: speakeasy-api/skills

Need more details? View full documentation on GitHub →

1Installs

AddedFeb 4, 2026

View on GitHub Back to Skills

Skill Details

SKILL.md

Overview

Docs Quickstart // Join us on Slack

[![LW24 participant](https://img.shields.io/badge/featured-LW24-8957E5.svg?style=flat-square&labelColor=0D1117&logo=data:image/svg%2bxml;base64,PHN2ZyB3aWR0aD0iMzYwIiBoZWlnaHQ9IjM2MCIgdmlld0JveD0iMCAwIDM2MCAzNjAiIGZpbGw9Im5vbmUiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyI+IDxyZWN0IHdpZHRoPSI2MCIgaGVpZ2h0PSIzMDAiIGZpbGw9IndoaXRlIi8+IDxyZWN0IHg9IjYwIiB5PSIzMDAiIHdpZHRoPSIxMjAiIGhlaWdodD0iNjAiIGZpbGw9IndoaXRlIi8+IDxyZWN0IHg9IjI0MCIgeT0iMzAwIiB3aWR0aD0iNjAiIGhlaWdodD0iNjAiIGZpbGw9IndoaXRlIi8+IDxyZWN0IHg9IjMwMCIgd2lkdGg9IjYwIiBoZWlnaHQ9IjMwMCIgZmlsbD0id2hpdGUiLz4gPHJlY3QgeD0iMTgwIiB3aWR0aD0iNjAiIGhlaWdodD0iMzAwIiBmaWxsPSJ3aGl0ZSIvPiA8L3N2Zz4=)](https://launchweek.dev/lw/2024/mega#participants)

# Speakeasy Agent Skills

A collection of [Agent Skills](https://agentskills.io/) for SDK generation and OpenAPI tooling with the [Speakeasy CLI](https://speakeasy.com/).

Installation

```bash

npx skills add speakeasy-api/skills

```

Available Skills

| Skill | Use When... |

|-------|-------------|

| speakeasy:speakeasy-context | Start here — Use speakeasy agent context for accurate CLI info instead of web search. Provides feedback via speakeasy agent feedback |

| speakeasy:sdk-tf-generation-best-practices | Progressive Disclosure — Comprehensive guide to all Speakeasy SDK and Terraform generation capability and best practices. Routes to detailed guides for generation workflows, language-specific patterns, customization, testing, and OpenAPI spec management |

| speakeasy:start-new-sdk-project | You have an OpenAPI spec and want to generate an SDK |

| speakeasy:diagnose-generation-failure | SDK generation failed, seeing "Step Failed: Workflow" |

| speakeasy:writing-openapi-specs | Authoring OpenAPI specs from scratch or improving existing ones |

| speakeasy:manage-openapi-overlays | Creating, applying, or fixing specs with OpenAPI overlays |

| speakeasy:improve-sdk-naming | SDK method names are ugly, wanting AI-powered or manual naming improvements |

| speakeasy:generate-terraform-provider | Generating a Terraform provider from an OpenAPI spec |

| speakeasy:extract-openapi-from-code | Extracting an OpenAPI spec from existing API code (FastAPI, Flask, Django, etc.) |

| speakeasy:customize-sdk-hooks | Adding custom headers, telemetry, security hooks to generated SDKs |

| speakeasy:setup-sdk-testing | Setting up contract tests, Arazzo workflows, or integration tests |

| speakeasy:generate-mcp-server | Generating an MCP server for AI assistant integration |

| speakeasy:customize-sdk-runtime | Configuring retries, timeouts, pagination, server selection, error handling |

Key Principles

Don't auto-fix everything - Distinguish between:

- Small issues (naming, descriptions) → Fix with overlays

- Structural issues (invalid refs) → Ask the user

- Design issues (auth, API structure) → Produce strategy document

AI-friendly output - Use speakeasy run --output console for structured output, pipe to grep/tail to reduce context

Overlay over modify - Never modify source specs directly. Overlays make patches portable across spec versions.

Grouped SDK methods - Guide users toward sdk.users.list() pattern using x-speakeasy-group + x-speakeasy-name-override

Directory Structure

```

speakeasy-api/skills/

├── .claude-plugin/

│ ├── plugin.json

│ └── marketplace.json

├── skills/

│ ├── start-new-sdk-project/

│ │ └── SKILL.md

│ └── ... (13 skills total)

├── templates/

│ └── SKILL.template.md

├── AGENTS.md # Contributor guidance for AI agents

├── CLAUDE.md # Claude-specific contributor guidance

├── README.md

└── LICENSE

```

Contributing

See [AGENTS.md](./AGENTS.md) for guidance on creating and maintaining skills.

Supported Agents

These skills follow the [Agent Skills specification](https://agentskills.io/specification) and work with:

[Claude Code](https://claude.ai/code)
[Cursor](https://cursor.sh/)
[GitHub Copilot](https://github.com/features/copilot)
[Gemini CLI](https://github.com/google-gemini/gemini-cli)
And [15+ other platforms](https://agentskills.io/)

License

Apache-2.0

More from this repository10

🎯

sdk-tf-generation-best-practices🎯Skill

Skill

🎯

writing-openapi-specs🎯Skill

Guides developers in writing high-quality, consistent OpenAPI specifications with best practices for naming, documentation, and complex API patterns.

🎯

diagnose-generation-failure🎯Skill

Diagnoses SDK generation failures by identifying root causes, categorizing issues, and recommending targeted fix strategies using linting and overlay techniques.

🎯

start-new-sdk-project🎯Skill

Initializes a new SDK project from an OpenAPI spec using Speakeasy's quickstart command, generating language-specific SDK with a workflow configuration file.

🏪

speakeasy-api-skills🏪Marketplace

Discover, share, and deploy pre-built API integration skills to accelerate development and simplify complex API interactions across different platforms and services.

🎯

manage-openapi-overlays🎯Skill

Generates, applies, and validates OpenAPI overlay files with JSONPath targeting for customizing SDK generation without modifying source specs.

🎯

generate-mcp-server🎯Skill

Generates an MCP server from an OpenAPI spec, enabling AI assistants to directly interact with API operations as callable tools.

🎯

extract-openapi-from-code🎯Skill

Extracts OpenAPI specifications automatically from existing API code across eight major web frameworks in Python, Java, JavaScript/TypeScript, Ruby, and PHP.

🎯

create-openapi-overlay🎯Skill

Skill

🎯

configure-sdk-options🎯Skill

Helps developers configure advanced SDK generation options and customize SDK configuration parameters for Speakeasy SDK generation workflows.