api-design
Design and review REST/GraphQL APIs for correctness, consistency, and security. Generates OpenAPI specs, validates endpoint design, and checks for common API pitfalls.
npx skills add majiayu000/claude-skill-registry --skill api-design-corbat-tech-coco --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.
# API Design Design and review APIs for the project being built. ## REST API Design Principles ### URL Structure ``` # ✅ Resource-based, plural, lowercase 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 # partial update 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 # ❌ Avoid verbs in URLs POST /api/v1/createUser # wrong GET /api/v1/getUserById # wrong ``` ### HTTP Status Codes | Code | When | |------|------| | 200 | Success (GET, PUT, PATCH) | | 201 | Created (POST) | | 204 | No content (DELETE) | | 400 | Bad request (validation error) | | 401 | Unauthenticated | | 403 | Unauthorized (authenticated but no permission) | | 404 | Not found | | 409 | Conflict (duplicate) | | 422 | Unprocessable entity | | 429 | Rate limited | | 500 | Internal server error | ### Response Format ```json // Success { "data": { ... }, "meta": { "total": 100, "page": 1 } } // Error { "error": { "code": "VALIDATION_ERROR", "message": "Email is invalid", "details": [{ "field": "email", "message":
- REST API Design Principles
- URL Structure
- HTTP Status Codes
- Response Format
- Versioning
- Security Checklist
- OpenAPI Spec Template
- Usage
What does the api-design skill do?
Design and review REST/GraphQL APIs for correctness, consistency, and security. Generates OpenAPI specs, validates endpoint design, and checks for common API pitfalls.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill api-design-corbat-tech-coco --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.