api-design
REST API design principles and best practices. Use when designing API endpoints, request/response schemas, versioning, error formats, or reviewing API design.
npx skills add majiayu000/claude-skill-registry --skill api-design-cohen-liel-hivemind --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.
# REST API Design Patterns ## URL Structure ``` # Resources (nouns, plural, lowercase-kebab) GET /api/v1/users # List users POST /api/v1/users # Create user GET /api/v1/users/{id} # Get user PUT /api/v1/users/{id} # Replace user PATCH /api/v1/users/{id} # Update user partially DELETE /api/v1/users/{id} # Delete user # Nested resources GET /api/v1/users/{id}/posts # User's posts POST /api/v1/users/{id}/posts # Create post for user # Actions (when CRUD doesn't fit) POST /api/v1/users/{id}/activate POST /api/v1/auth/login POST /api/v1/auth/logout POST /api/v1/auth/refresh # Search / filtering GET /api/v1/posts?status=published&author=123&sort=-created_at&page=2&limit=20 ``` ## Status Codes ``` 200 OK — GET/PATCH/PUT success with body 201 Created — POST success (include Location header) 204 No Content — DELETE success 400 Bad Request — Invalid input (validation error) 401 Unauthorized — Not authenticated (no/invalid token) 403 Forbidden — Authenticated but not allowed 404 Not Found — Resource doesn't exist 409 Conflict — Duplicate email, version conflict 422 Unprocessable — Semantically invalid (used by FastAPI for validation) 429 Too Many Reqs — Rate limit exceeded 500 Server Error —
- URL Structure
- Status Codes
- Request / Response Format
- Filtering & Pagination
- Versioning
- Response Headers
- Rules
What does the api-design skill do?
REST API design principles and best practices. Use when designing API endpoints, request/response schemas, versioning, error formats, or reviewing API design.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill api-design-cohen-liel-hivemind --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.