What problem does it solve? APIs built by different teams or over time often return inconsistent response shapes, pagination formats, error structures, and status codes, forcing frontend and API consumers to write special-case handling for every endpoint. ## Core Features & Use Cases - Standard Response Envelope: Defines shared TypeScript types (ApiResponse, ApiError, PaginatedResponse) so every endpoint returns the same success/data/error/meta structure. - Normalization Middleware: Provides Express middleware that automatically wraps responses and errors into the standard format without rewriting every route handler. - Pagination, Error Taxonomy & Versioning: Standardizes offset and cursor pagination, maps error codes to HTTP status codes, and sets up URL-based API versioning. - Migration Plan & OpenAPI Docs: Includes a phased rollout strategy and an OpenAPI specification so existing clients are not broken during adoption. - Use Case: A backend team with dozens of inconsistent REST endpoints uses this Skill to audit the inconsistencies, generate shared contract types, deploy normalization middleware, and publish a unified OpenAPI contract. ## Quick Start Ask the AI to audit the API endpoints in this repository and generate a standardized response contract with normalization middleware and a migration plan.
