designing-apis

npx skills add majiayu000/claude-skill-registry --skill designing-apis-ancoleman-ai-design-components --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

# Designing APIs Design well-structured, scalable APIs using REST, GraphQL, or event-driven patterns. Focus on resource design, versioning, error handling, pagination, rate limiting, and security. ## When to Use This Skill Use when: - Designing a new REST, GraphQL, or event-driven API - Establishing API design standards for a team or organization - Choosing between REST, GraphQL, WebSockets, or message queues - Planning API versioning and breaking change management - Defining error response formats and HTTP status code usage - Implementing pagination, filtering, and rate limiting patterns - Designing OAuth2 flows or API key authentication - Creating OpenAPI or AsyncAPI specifications Do NOT use for: - Implementation code (use `api-patterns` skill for Express, FastAPI code) - Authentication implementation (use `auth-security` skill for JWT, sessions) - API testing strategies (use `testing-strategies` skill) - API deployment and infrastructure (use `deploying-applications` skill) ## Core Design Principles ### Resource-Oriented Design (REST) Use nouns for resources, not verbs in URLs: ``` ✓ GET /users List users ✓ GET /users/123 Get user 123 ✓ POST /users Create user ✓ PATCH /users/12