What problem does it solve? Designing or auditing an API requires deep knowledge of REST and GraphQL conventions, security practices, and versioning strategies, and inconsistencies often slip into production endpoints. This Skill inspects your actual codebase and produces concrete, standards-based design recommendations. ## Core Features & Use Cases - Codebase-Aware Analysis: Uses Read, Glob, and Grep to locate routes, controllers, resolvers, and schemas, then identifies your framework (Express, NestJS, Fastify, Apollo) before reviewing. - Comprehensive Design Guidance: Covers RESTful resource naming, HTTP methods and status codes, GraphQL schema design, versioning strategies, authentication, rate limiting, pagination, and error response structures. - Interactive Scoping: Asks whether you are working with REST, GraphQL, or both, and whether your goal is security hardening, performance, developer experience, or a full review. - Use Case: Ask it to audit an Express REST API for an e-commerce app, and it will inventory endpoints, flag missing authentication checks, recommend a URL versioning strategy, and output a structured markdown report with sample requests and responses. ## Quick Start Ask the assistant to review the API design of this project and suggest improvements for security and naming conventions.
