Loading skill
Install any skill in seconds. Free to start, no credit card required.
Get Started Free →cloudai-x/designing-apis
Designs REST and GraphQL APIs including endpoints, error handling, versioning, and documentation.
Passed 23 of 24 test cases with the skill, and 19 of 24 without it.
and 4 more in the full report
4 fixed19 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.
Our team is establishing an API design workflow. At what point in the workflow should documentation with OpenAPI specs and validation against a design checklist be performed?
| Checked | Without skill | With skill |
|---|---|---|
| Identifies Step 6 as OpenAPI spec documentation. | Missed | Passed |
| Identifies Step 7 as design validation against checklist. | Missed | Passed |
The instructions your model reads when the skill loads.
Copy this checklist and track progress:
API Design Progress:
- [ ] Step 1: Define resources and relationships
- [ ] Step 2: Design endpoint structure
- [ ] Step 3: Define request/response formats
- [ ] Step 4: Plan error handling
- [ ] Step 5: Add authentication/authorization
- [ ] Step 6: Document with OpenAPI spec
- [ ] Step 7: Validate design against checklist
# Resource-based URLs (nouns, not verbs)
GET /users # List users
GET /users/:id # Get user
POST /users # Create user
PUT /users/:id # Replace user
PATCH /users/:id # Update user
DELETE /users/:id # Delete user
# Nested resources
GET /users/:id/orders # User's orders
POST /users/:id/orders # Create order for user
# Query parameters for filtering/pagination
test cases passed, vs 19 / 24 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.