Design REST API conventions for resource naming, HTTP methods, and pagination.
npx skills add https://github.com/Oruga420/claude-code-skills --skill api-design-oruga420
Please help me install this Agent Skill. Skill: api-design Source: https://github.com/Oruga420/claude-code-skills/tree/main/api-design Command: npx skills add https://github.com/Oruga420/claude-code-skills --skill api-design-oruga420
Reduce inconsistent, confusing, and fragile REST APIs by providing clear conventions for resource naming, HTTP semantics, response formats, and operational controls so teams deliver predictable, developer-friendly endpoints.
Use the api-design skill to review and standardize a new users API so endpoints use plural kebab-case, correct HTTP methods and status codes, a consistent response envelope, cursor pagination for lists, and appropriate rate-limit and versioning headers.
High-intent search queries and answers about installing and using this skill.
Design a consistent REST API by enforcing plural kebab-case resource naming, correct HTTP method semantics, and structured response envelopes. This ensures predictable, developer-friendly endpoints with clear idempotency rules and accurate success or error status codes.
The best way to implement pagination and filtering is applying cursor pagination for large lists and standard filter or sort conventions. This approach prevents performance bottlenecks and provides stable response payloads for public-facing REST APIs.
Structure error handling by returning consistent error envelopes with appropriate HTTP status codes. Configure rate limiting by adding standard rate-limit headers to control traffic and protect production REST API endpoints from abuse.
You need a versioning policy for your REST API when introducing breaking changes to public or partner-facing endpoints. Establish version deprecation timelines to manage transitions smoothly while maintaining backward compatibility for existing clients.
Yes, you can apply this approach to partner-facing services using token-based authentication patterns. It standardizes authentication requirements, rate limiting, and response formats to ensure reliable integration for external partners.
eng-vmessiahStandardizes REST API architecture including naming conventions, HTTP semantics, and error formats.
HouseGarofaloDesign, document, and generate APIs from OpenAPI and Swagger specifications.
altrupetsImplement API Gateway patterns and rate limiting with Kong or Nginx.
Camilo8902Migrate REST APIs to GraphQL incrementally using schema stitching and REST data source wrappers.
