api-design
RESTful API patterns, GraphQL design, and API best practices. Use when designing APIs, choosing between REST/GraphQL/tRPC, structuring endpoints, versioning, or documenting APIs.
npx skills add majiayu000/claude-skill-registry --skill api-design-dgkngk-super-kit --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 Skill ## Overview RESTful API patterns, GraphQL design, and API best practices. ## RESTful Design Principles ### 1. Resource Naming ``` ✅ Good: GET /users # List users GET /users/123 # Get user POST /users # Create user PUT /users/123 # Update user DELETE /users/123 # Delete user ❌ Bad: GET /getUsers POST /createUser GET /user/delete/123 ``` ### 2. HTTP Status Codes ```typescript // Success 200 OK - Successful GET/PUT 201 Created - Successful POST 204 No Content - Successful DELETE // Client Errors 400 Bad Request - Invalid input 401 Unauthorized - Auth required 403 Forbidden - No permission 404 Not Found - Resource doesn't exist 422 Unprocessable - Validation failed // Server Errors 500 Internal Error - Server bug 503 Service Unavailable - Maintenance ``` ### 3. Response Format ```typescript // Success response { "data": { "id": "123", "name": "John", "email": "john@example.com" } } // Error response { "error": { "code": "VALIDATION_ERROR", "message": "Email is required", "details": [ { "field": "email", "message": "This field is required" } ] } } // List with pagination { "data": [...], "meta": { "page": 1, "perPage": 20, "total": 150, "totalPages": 8 } } ``` ### 4.
- Overview
- RESTful Design Principles
- 1. Resource Naming
- 2. HTTP Status Codes
- 3. Response Format
- 4. Pagination
- 5. Filtering & Sorting
- API Versioning
- Rate Limiting
- Input Validation
What does the api-design skill do?
RESTful API patterns, GraphQL design, and API best practices. Use when designing APIs, choosing between REST/GraphQL/tRPC, structuring endpoints, versioning, or documenting APIs.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill api-design-dgkngk-super-kit --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.