# Sdk Generator

> Generate typed client SDKs from OpenAPI specifications for TypeScript, Python, Go, and other languages

- Skill: `uitbreidenos/sdk-generator` (Agent Skill)
- Install (CLI): `npx skillmds@latest add uitbreidenos/sdk-generator`
- Raw SKILL.md: https://api.skillmd.com/api/skills/uitbreidenos/sdk-generator/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: UitbreidenOS (https://skillmd.com/u/uitbreidenos)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/uitbreidenos/sdk-generator

---


## When to activate

- Generating client SDKs from OpenAPI specs
- Creating typed API clients for TypeScript/JavaScript
- Building Python client libraries with type hints
- Setting up auto-generated SDKs in CI/CD pipelines
- Maintaining SDK parity with API changes

## When NOT to use

- For manual API wrapper development
- For GraphQL client generation
- For internal RPC client stubs

## Instructions

1. **Validate OpenAPI spec.** Ensure spec passes spectral linting before generation — garbage in, garbage out.
2. **Select generator.** OpenAPI Generator, Speakeasy, or Fern depending on quality requirements.
3. **Configure generator.** Set package name, version, output directory, and language-specific options.
4. **Generate SDK.** Run generator; review output for completeness and type safety.
5. **Add customizations.** Custom HTTP client configuration, retry logic, timeout overrides, and middleware hooks.
6. **Write usage examples.** 3-5 examples covering common workflows: CRUD operations, pagination, error handling.
7. **Publish SDK.** Configure npm/PyPI/Go module publishing in CI pipeline triggered by spec changes.

## Example

```typescript
// Generated TypeScript SDK usage
import { UsersApi } from '@company/api-sdk';

const api = new UsersApi({ apiKey: process.env.API_KEY });

// List users with pagination
const users = await api.listUsers({ page: 1, limit: 20 });
console.log(users.data); // User[]
console.log(users.meta.total); // number

// Error handling
try {
  await api.createUser({ email: 'invalid' });
} catch (err) {
  if (err instanceof ValidationError) {
    console.log(err.details); // FieldError[]
  }
}
```