Designing Apis

This walks you through the full API design workflow, from resource modeling to OpenAPI specs. It gives you clean patterns for REST endpoints (resource-based URLs, proper status codes, pagination), GraphQL schemas with input types and error handling, and versioning strategies. The validation checklists are genuinely useful because they catch common mistakes like using verbs in URLs or forgetting rate limit headers. It's opinionated in good ways, like recommending URL versioning over header versioning, and the response format examples are copy-paste ready. If you're tired of inconsistent APIs across your team or just want a structured approach instead of making it up as you go, this gives you the guardrails without being dogmatic.

Install to Claude Code

npx -y skills add cloudai-x/claude-workflow-v2 --skill designing-apis --agent claude-code