api-rest-design
Apply when designing RESTful APIs, defining endpoints, HTTP methods, status codes, and response formats.
npx skills add majiayu000/claude-skill-registry --skill api-rest-design --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
## When to Use Apply when designing RESTful APIs, defining endpoints, HTTP methods, status codes, and response formats. ## Patterns ### Pattern 1: Resource Naming ``` # Source: https://restfulapi.net/resource-naming/ GOOD: GET /users # List users GET /users/123 # Get user 123 POST /users # Create user PUT /users/123 # Update user 123 DELETE /users/123 # Delete user 123 GET /users/123/orders # User's orders (nested resource) BAD: GET /getUsers # Verb in URL POST /createUser # Verb in URL GET /user/123 # Singular (use plural) ``` ### Pattern 2: HTTP Status Codes ``` # Source: https://www.rfc-editor.org/rfc/rfc9110 Success: 200 OK - GET/PUT success with body 201 Created - POST success, include Location header 204 No Content - DELETE success, no body Client Errors: 400 Bad Request - Invalid input/payload 401 Unauthorized - Missing/invalid auth 403 Forbidden - Auth valid, no permission 404 Not Found - Resource doesn't exist 409 Conflict - Resource state conflict 422 Unprocessable - Validation failed Server Errors: 500 Internal - Unexpected server error 503 Unavailable - Service temporarily down ``` ### Pattern 3: Response Format ```typescript // Source: https://restfulapi.net/ // Succes
- When to Use
- Patterns
- Pattern 1: Resource Naming
- Pattern 2: HTTP Status Codes
- Pattern 3: Response Format
- Pattern 4: Filtering & Pagination
- Pattern 5: Versioning
- Anti-Patterns
- Verification Checklist
What does the api-rest-design skill do?
Apply when designing RESTful APIs, defining endpoints, HTTP methods, status codes, and response formats.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill api-rest-design --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.