Api Design

Covers REST conventions, GraphQL schema design, versioning strategies, and RFC 9457 Problem Details error handling across 18 rules in 7 categories. You'll reach for this when deciding between URL path versioning and header versioning, implementing standardized error responses with `application/problem+json`, or setting up OpenAPI specs. The agent-facing errors section is especially solid, adding `retryable` and `error_category` fields that actually help AI clients handle failures intelligently. Also includes patterns for gRPC services, SSE/WebSocket streaming, and messaging platform integrations like WhatsApp and Telegram. The deprecation and sunset policy guidance (3 month notice, 6 month window) is more opinionated than most API skills, which is helpful when you need a concrete answer rather than endless options.

Install to Claude Code

npx -y skills add yonatangross/orchestkit --skill api-design --agent claude-code