{"product_id":"ultimate-api-design-review-enhance-your-rest-graphql-contracts","title":"Ultimate API Design Review: Enhance Your REST \u0026 GraphQL Contracts","description":"\u003ch3\u003eUltimate API Design Review: Enhance Your REST \u0026amp; GraphQL Contracts\u003c\/h3\u003e\n\n\u003cp\u003eThis AI agent skill provides a structured review of API contracts for REST and GraphQL, focusing on resource naming, HTTP semantics, status codes, error shape, pagination, versioning, idempotency, and backward compatibility. It aids developers in producing concrete revisions rather than abstract advice during the design or modification of API endpoints.\u003c\/p\u003e\n\n\u003ch3\u003eWhat this skill does\u003c\/h3\u003e\n\u003cul\u003e\n  \u003cli\u003eFirst, it establishes the existing API contract by analyzing current routes and resolvers, including path, verbs, request\/response shapes, and error handling.\u003c\/li\u003e\n  \u003cli\u003eIt identifies existing conventions such as error envelope shape, pagination style, naming case, plural vs. singular resources, authentication mechanism, and versioning scheme.\u003c\/li\u003e\n  \u003cli\u003eIt evaluates new or changed API surfaces against the existing conventions, ensuring consistency with current API output unless there is a stated reason for divergence.\u003c\/li\u003e\n  \u003cli\u003eThe skill produces a checklist-driven review for each modification or addition, grounded in the project’s prevailing standards.\u003c\/li\u003e\n\u003c\/ul\u003e\n\n\u003ch3\u003eWho it is for\u003c\/h3\u003e\n\u003cul\u003e\n  \u003cli\u003eAPI Developers seeking to maintain or enhance the consistency and reliability of their contract interfaces.\u003c\/li\u003e\n  \u003cli\u003eDevelopment teams focusing on REST or GraphQL API projects, looking for robust review processes.\u003c\/li\u003e\n  \u003cli\u003eProfessionals utilizing AI coding agents like Claude Code, Cursor, and Codex to manage their workflow.\u003c\/li\u003e\n\u003c\/ul\u003e\n\n\u003ch3\u003eUse cases\u003c\/h3\u003e\n\u003cul\u003e\n  \u003cli\u003eReviewing API contracts during the design phase to avoid potential consumer-side inconsistencies.\u003c\/li\u003e\n  \u003cli\u003eAssessing a pull request that introduces or alters API routes to ensure alignment with existing standards.\u003c\/li\u003e\n  \u003cli\u003eFacilitating team discussions around API changes with evidence-based evaluations of current conventions.\u003c\/li\u003e\n\u003c\/ul\u003e\n\n\u003ch3\u003eTechnical details\u003c\/h3\u003e\n\u003cul\u003e\n  \u003cli\u003eIntegrates seamlessly with aiapplication, agentic-tools, and api-design-review modules.\u003c\/li\u003e\n  \u003cli\u003eCompatible with developers using AI tools like Claude Code, Cursor, and Codex for enhanced API management.\u003c\/li\u003e\n\u003c\/ul\u003e\n\u003c!-- mcpcart:static-blocks:start --\u003e\n\u003chr\u003e\n\u003ch3\u003eSource \u0026amp; Licence\u003c\/h3\u003e\n\u003cp\u003eThis package is built on open-source work published by \u003cstrong\u003eKhaledSaeed18\u003c\/strong\u003e (\u003ca href=\"https:\/\/github.com\/KhaledSaeed18\/dotclaude\" rel=\"nofollow noopener\" target=\"_blank\"\u003eKhaledSaeed18\/dotclaude\u003c\/a\u003e) and distributed under \u003cstrong\u003eMIT\u003c\/strong\u003e. The original licence text and copyright notice are included in your download.\u003c\/p\u003e\n\u003cp\u003ePersonal and commercial use, modification and redistribution are permitted, provided the original copyright and licence notice are retained.\u003c\/p\u003e\n\u003cp\u003eYour purchase covers curation, licence verification, packaging, documentation and instant delivery. It does not grant exclusive rights to the underlying open-source code, which remains available under its original licence.\u003c\/p\u003e\n\u003ch3\u003eDelivery \u0026amp; Support\u003c\/h3\u003e\n\u003cul\u003e\n\u003cli\u003e\n\u003cstrong\u003eDelivery:\u003c\/strong\u003e instant — a secure download link is emailed to you as soon as payment is confirmed.\u003c\/li\u003e\n\u003cli\u003e\n\u003cstrong\u003eFormat:\u003c\/strong\u003e ZIP archive containing the skill files, documentation and the original licence.\u003c\/li\u003e\n\u003cli\u003e\n\u003cstrong\u003eSupport:\u003c\/strong\u003e \u003ca href=\"mailto:support@mcpcart.com\"\u003esupport@mcpcart.com\u003c\/a\u003e — we aim to reply within 2 business days.\u003c\/li\u003e\n\u003cli\u003e\n\u003cstrong\u003eUpdates:\u003c\/strong\u003e updates are included only where stated on this page.\u003c\/li\u003e\n\u003c\/ul\u003e\n\u003ch3\u003eRefunds\u003c\/h3\u003e\n\u003cp\u003eThis is a digital product delivered immediately after purchase. By completing your order you request immediate delivery and acknowledge that, once the download has been accessed, the statutory right to cancel no longer applies to the extent permitted by law. Refund requests are handled in accordance with our published Refund Policy.\u003c\/p\u003e\n\u003cp style=\"font-size:0.85em;color:#666;\"\u003eClaude, Codex, Gemini and Cursor are trademarks of their respective owners. MCP Cart is an independent marketplace and is not affiliated with, endorsed by, or sponsored by any of them. Compatibility references describe interoperability only.\u003c\/p\u003e\n\u003c!-- mcpcart:static-blocks:end --\u003e","brand":"MCP Cart","offers":[{"title":"Default Title","offer_id":52870456607031,"sku":"MCP-KHALEDSAEED18-DOTCLAUDE-API-DESIGN-REVIEW","price":37.99,"currency_code":"GBP","in_stock":true}],"thumbnail_url":"\/\/cdn.shopify.com\/s\/files\/1\/0981\/3950\/4951\/files\/FvGKgSaLJUZZdexnPNMEu_a9d695e8916643af8e51b22d5b9a29fc.jpg?v=1787217120","url":"https:\/\/mcpcart.com\/products\/ultimate-api-design-review-enhance-your-rest-graphql-contracts","provider":"SPF PRO","version":"1.0","type":"link"}