What problem does it solve? Designing consistent REST APIs is hard: teams often mix naming styles, return 200 for every response, skip pagination, and leak internal errors. This Skill provides a complete set of conventions and implementation patterns so every endpoint follows the same predictable contract. ## Core Features & Use Cases - Resource & URL Conventions: Enforces plural, kebab-case, noun-based URLs with correct HTTP method semantics and status codes (201 with Location, 422 for validation, 429 for rate limits). - Pagination, Filtering & Sorting: Covers offset-based and cursor-based pagination, bracket-notation filtering, multi-field sorting, and sparse fieldsets. - Standard Response Formats: Defines success envelopes, collection metadata with links, and structured error responses with field-level details. - Implementation Patterns: Ready-to-adapt examples in TypeScript (Next.js + Zod), Python (Django REST Framework), and Go (net/http), plus auth, rate limiting, and versioning strategies. - Use Case: When adding a new endpoint to a production API, activate this Skill to validate the URL design, pick the right status codes, add cursor pagination, and produce a standards-compliant error format before shipping. ## Quick Start Ask the AI to design a new REST endpoint for creating orders following the api-design conventions, including validation, status codes, and error response format.
