Provides REST API design and implementation standards. Ensures proper URL structure, pagination, sorting, filtering, and error handling patterns. Specializes in RESTful principles, HTTP method semantics, status code usage, versioning strategies, HATEOAS, and API documentation. Implements consistent response structures and content negotiation. Use when: designing REST API endpoints, defining URL structures and naming conventions, implementing pagination/sorting/filtering, choosing appropriate HTTP methods (GET/POST/PUT/PATCH/DELETE), selecting HTTP status codes, designing request/response schemas, handling API errors and validation, implementing API versioning, documenting APIs with OpenAPI/Swagger, or designing hypermedia controls (HATEOAS).
4.3
Rating
0
Installs
Backend Development
Category
The skill provides a solid foundation of REST API design standards covering essential topics like naming conventions, pagination, sorting, filtering, URL structure, and error handling. The description is clear and comprehensive. However, the task knowledge is somewhat superficial—while it lists what to do (e.g., 'use cursor-based pagination'), it lacks implementation examples, code snippets, or deeper guidance on trade-offs and edge cases. The structure is adequate but could benefit from more detailed sections or referenced examples. The novelty is moderate; while REST API design has nuances, much of this information is readily available in standard documentation, and a capable CLI agent could likely construct similar guidance without extensive token usage. The skill would be more valuable with concrete implementation patterns, language-specific examples, or complex scenarios (like advanced HATEOAS implementations or multi-version API management).
majiayu000
Skill Author
Loading SKILL.md…
