SDK Scaffolder Protocol

This skill focuses on Developer Experience (DX). Auto-generated clients (via standard Swagger/OpenAPI generators) are notoriously ugly, verbose, and lack domain-specific resilience. This skill generates idiomatic code tailored to a specific language's best practices.

Core assumption: If your SDK is hard to use, developers won't use your API. An SDK is a product in itself.

1. Context & Language Analysis (Static)

Read the API OpenAPI specification and target language (e.g., Python httpx vs requests, or TypeScript fetch vs axios).

2. Idiomatic Design Enforcement

Generate an SDK structure that includes:

• Resilient Core: A base HttpClient that automatically handles retries (with exponential backoff) for 429 and 5xx errors.
• Timeouts: A mandatory default timeout (e.g., 10s) to prevent hanging sockets.
• Pagination Helpers: Abstract away limit/offset or cursor logic into generator functions or async iterators.
• Strong Typing: Fully typed request/response models (e.g., Pydantic for Python, Zod for TypeScript).

3. Output Generation