Loading skill
Install any skill in seconds. Free to start, no credit card required.
Get Started Free →loulanyue/api-design
REST API design patterns including resource naming, status codes, pagination, filtering, error responses, versioning, and rate limiting for production APIs.
Passed 21 of 22 test cases with the skill, and 17 of 22 without it.
and 4 more in the full report
4 fixed17 passed either way1 still failing0 broke
Tokens, turns and time describe resource use, not a dollar price.
One of 4 test cases the skill fixed. Same model, same prompt, with and without the skill.
I am designing a RESTful API for a SaaS application's workspace member management. Could you provide a comprehensive API design specification that covers resource endpoint naming, appropriate HTTP verbs, standard response structures for single resources and list endpoints, status codes, and authorization guidelines?
| Checked | Without skill | With skill |
|---|---|---|
| Structures error responses using a top-level error envelope containing code, message, and details without RFC 7807 problem details fields. | Missed | Passed |
| Uses per_page and page fields inside a meta object for offset pagination metadata. | Passed | Passed |
| Includes a Location header in HTTP 201 Created responses for resource creation. | Missed | Passed |
The instructions your model reads when the skill loads.
Conventions and best practices for designing consistent, developer-friendly REST APIs.
# Resources are nouns, plural, lowercase, kebab-case
GET /api/v1/users
GET /api/v1/users/:id
POST /api/v1/users
PUT /api/v1/users/:id
PATCH /api/v1/users/:id
DELETE /api/v1/users/:id
# Sub-resources for relationships
GET /api/v1/users/:id/orders
POST /api/v1/users/:id/orders
# Actions that don't map to CRUD (use verbs sparingly)
POST /api/v1/orders/:id/cancel
POST /api/v1/auth/login
POST /api/v1/auth/refresh
# GOOD
test cases passed, vs 17 / 22 without
Published skills whose descriptions closely match this one, with their headline benchmark lift.
More skills from the same source and nearby in the registry, with their headline benchmark lift.