What problem does it solve? Designing consistent, scalable APIs is hard: teams struggle with inconsistent naming, missing pagination, poor error formats, N+1 query problems in GraphQL, and unplanned versioning that breaks clients. This Skill provides concrete REST and GraphQL design patterns, code templates, and review checklists to produce well-structured APIs. ## Core Features & Use Cases - REST Design Patterns: Resource-oriented endpoints, HTTP method semantics, pagination and filtering, HATEOAS links, and standardized error responses with correct status codes. - GraphQL Design Patterns: Schema-first development, Relay-style cursor pagination, DataLoader-based N+1 prevention, input/payload mutation patterns, and deprecation strategies. - Ready-to-Use Resources: A FastAPI REST template, a GraphQL schema design reference, and a comprehensive pre-implementation review checklist. - Use Case: When designing a new users API, apply the resource-oriented endpoint patterns, add cursor or offset pagination, standardize error responses, and run the checklist before implementation to catch missing rate limits, auth checks, or documentation gaps. ## Quick Start Use the api-design-principles skill to review my planned /api/users endpoints and generate a paginated FastAPI implementation with proper error handling.
