api-designerlisted

# API Designer ## Overview This skill provides comprehensive guidance for designing, documenting, and implementing modern APIs. It covers both REST and GraphQL paradigms, with emphasis on industry best practices, clear documentation, and maintainable architecture. Use this skill to create production-ready API designs that are scalable, secure, and developer-friendly. ## Core Capabilities ### REST API Design - Resource-oriented endpoint design with proper URL structure - HTTP method semantics and status code usage - Request/response payload design with consistent naming - Pagination, filtering, and sorting strategies - Error handling and validation patterns ### GraphQL API Design - Schema definition with type system and relationships - Query and mutation design with proper input types - Resolver patterns and performance optimization - Fragment usage and directive implementation - N+1 problem prevention strategies ### API Documentation - OpenAPI 3.0 specification generation - Interactive documentation with Swagger UI - Authentication and authorization documentation - Example requests/responses with multiple scenarios - Code generation from specifications ### Authentication & Authorization - OAuth 2.0 flows (authorization code, client credentials, PKCE) - JWT token design, validation, and rotation - API key management and rotation strategies - Role-based access control (RBAC) implementation - Rate limiting and throttling patterns ### API Versioning - URL versioning and h