Generate client SDKs in multiple languages from OpenAPI specifications.
SkillScore60Maintained
Automatic
◆Coding packapiapi-sdks
Last verified 8/30/2026
What it changes
Passed 14 of 24 test cases with the skill, and 12 of 24 without it.
Without skill52%
With skill60%
Checks it passed that the model alone missed
Exposes a `retryConfig` option to disable built-in retry logic.
Provides async pagination support using `__aiter__` or async generators.
Validates authentication, error retries, and pagination within test suites.
3 fixed12 passed either way9 still failing1 broke
Pass-rate lift
+8 pp
Tokens
+40%
Agent turns
0%
Response time
+13%
Model gemini-3.6-flashMeasured 8/30/2026v115 of 25 cases passed with skill · 24 comparable
Tokens, turns and time describe resource use, not a dollar price.
See it in action
One of 3 test cases the skill fixed. Same model, same prompt, with and without the skill.
1 of 3
Prompt
In our Python SDK generated from `analytics-spec.json`, our application already has a global retry layer using Resilience4j. How should the generated SDK allow applications to opt out of internal retries while still monitoring retry events?
What was checked, without and with the skill
Checked
Without skill
With skill
Exposes a `retryConfig` option to disable built-in retry logic.
Missed
Passed
Emits retry events for observability.
Passed
Passed
case-08 · gemini-3.6-flash · 8/30/2026 · answers are capped and redacted
What's inside
The instructions your model reads when the skill loads.
SKILL.md65 lines4 files
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
Read and validate the OpenAPI specification using Read, checking for complete schema definitions, proper $ref usage, and response type coverage across all endpoints.
Extract all operation IDs, request/response models, and authentication schemes from the specification to build the SDK method inventory.
Generate typed model classes for every schema component, including nested objects, enums, and discriminated unions with proper nullability annotations.
Create a client class with methods for each API operation, mapping operation IDs to idiomatic method names (e.g., listUsers, get_user, CreateUser).
Implement authentication handling with support for Bearer tokens, API keys (header and query), and OAuth2 client credentials flow, configurable at client instantiation.
Add automatic retry logic with exponential backoff for 429 and 5xx responses, with configurable max retries and backoff multiplier.
Build pagination helpers that abstract cursor-based and offset pagination into iterator/generator patterns native to each target language.
Generate comprehensive JSDoc/docstring/Javadoc comments from OpenAPI description and summary fields for full IDE IntelliSense support.
Create a test suite that validates SDK methods against a mock server running the OpenAPI spec, covering authentication, error handling, and pagination.
See ${CLAUDE_SKILL_DIR}/references/implementation.md for the full implementation guide.
Output
${CLAUDE_SKILL_DIR}/sdk/typescript/src/client.ts - Main SDK client class with typed methods
${CLAUDE_SKILL_DIR}/sdk/typescript/src/models/ - TypeScript interfaces and type definitions
${CLAUDE_SKILL_DIR}/sdk/python/client.py - Python SDK with dataclass models and async support
${CLAUDE_SKILL_DIR}/sdk/go/client.go - Go SDK with struct types and context-based methods
${CLAUDE_SKILL_DIR}/sdk/*/README.md - Per-language installation and usage documentation
${CLAUDE_SKILL_DIR}/sdk/*/tests/ - SDK test suites per language