Agent skill · software engineering · jeremylongshore
generating-api-sdks
Generate client SDKs in multiple languages from OpenAPI specifications.
Why this skill is useful
Adds a complete SDK generation workflow with executable scripts for multiple languages based on OpenAPI specifications.
What it needs
Requires go, java, node, openapi-generator-cli, python installed locally. About 3k tokens when loaded. Last updated 2026-08-07. 2,604 stars on the source repository.
What this skill does
Generating API SDKs Overview Generate type-safe client SDKs in multiple languages (TypeScript, Python, Go, Java) from OpenAPI 3.0+ specifications. Produce idiomatic client libraries with authentication handling, automatic retries, pagination helpers, and comprehensive type definitions that mirror the API contract. Prerequisites OpenAPI 3.0+ specification file (YAML or JSON) with complete schema definitions Target language toolchain installed (Node.js/TypeScript, Python 3.10+, Go 1.21+, or Java 17+) OpenAPI Generator CLI or equivalent code generation tool Package registry credentials for publishing (npm, PyPI, Maven Central, pkg.go.dev) CI pipeline for automated SDK builds on spec changes Instructions 1. Read and validate the OpenAPI specification using Read, checking for complete schema definitions, proper $ref usage, and response type coverage across all endpoints. 2. Extract all operation IDs, request/response models, and authentication schemes from the specification to build the SDK method inventory. 3. Generate typed model classes for every schema component, including nested objects, enums, and discriminated unions with proper nullability annotations. 4. Create a client class with methods for each API operation, mapping operation IDs to idiomatic method names (e.g., listUsers, getuser, CreateUser). 5. Implement authentication handling with support for Bearer tokens, API keys (header and query), and OAuth2 client credentials flow, configurable at client instantiation. 6. Add automatic retry logic with exponential backoff for 429 and 5xx responses, with configurable max retries and backoff multiplier. 7. Build pagination helpers that abstract cursor-based and offset pagination into iterator/generator patterns native to each target language. 8. Generate comprehensive JSDoc/docstring/Javadoc comments from OpenAPI description and summary fields for full IDE IntelliSense support. 9. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills jeremylongshore/generating-api-sdks