designing-sdks
Design production-ready SDKs with retry logic, error handling, pagination, and multi-language support. Use when building client libraries for APIs or creating developer-facing SDK interfaces.
npx skills add majiayu000/claude-skill-registry --skill designing-sdks --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# SDK Design Design client libraries (SDKs) with excellent developer experience through intuitive APIs, robust error handling, automatic retries, and consistent patterns across programming languages. ## When to Use This Skill Use when building a client library for a REST API, creating internal service SDKs, implementing retry logic with exponential backoff, handling authentication patterns, creating typed error hierarchies, implementing pagination with async iterators, or designing streaming APIs for real-time data. ## Core Architecture Patterns ### Client → Resources → Methods Organize SDK code hierarchically: ``` Client (config: API key, base URL, retries, timeout) ├─ Resources (users, payments, posts) │ ├─ create(), retrieve(), update(), delete() │ └─ list() (with pagination) └─ Top-Level Methods (convenience) ``` **Resource-Based (Stripe style):** ```typescript const client = new APIClient({ apiKey: 'sk_test_...' }) const user = await client.users.create({ email: 'user@example.com' }) ``` Use for APIs <100 methods. Prioritizes developer experience. **Command-Based (AWS SDK v3):** ```typescript import { S3Client, PutObjectCommand } from '@aws-sdk/client-s3' await client.send(new
- When to Use This Skill
- Core Architecture Patterns
- Client → Resources → Methods
- Language-Specific Patterns
- TypeScript: Async-Only
- Python: Dual Sync/Async
- Go: Sync with Context
- Authentication
- API Key (Most Common)
- OAuth Token Refresh
- Bearer Token Per-Request
- Retry and Backoff
- Exponential Backoff with Jitter
- Rate Limit Handling
What does the designing-sdks skill do?
Design production-ready SDKs with retry logic, error handling, pagination, and multi-language support. Use when building client libraries for APIs or creating developer-facing SDK interfaces.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill designing-sdks --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.