api-design
RESTful API and GraphQL design best practices. Auto-triggers when designing endpoints, handling HTTP methods, or structuring API responses.
npx skills add majiayu000/claude-skill-registry --skill api-design-bigdegenenergy-ai-dev-toolkit --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 ## REST Design Principles ### Resource Naming - Use nouns, not verbs: `/users` not `/getUsers` - Use plural for collections: `/users`, `/orders` - Use kebab-case: `/user-profiles` - Nest for relationships: `/users/{id}/orders` - Maximum 3 levels deep ### HTTP Methods | Method | Purpose | Idempotent | Safe | |--------|---------|------------|------| | GET | Read resource | Yes | Yes | | POST | Create resource | No | No | | PUT | Replace resource | Yes | No | | PATCH | Partial update | No | No | | DELETE | Remove resource | Yes | No | ### Status Codes ``` 2xx Success 200 OK - General success 201 Created - Resource created (return Location header) 204 No Content - Success with no body (DELETE) 4xx Client Error 400 Bad Request - Invalid input 401 Unauthorized - Authentication required 403 Forbidden - Authenticated but not permitted 404 Not Found - Resource doesn't exist 409 Conflict - State conflict (duplicate) 422 Unprocessable Entity - Validation failed 429 Too Many Requests - Rate limited 5xx Server Error 500 Internal Server Error - Unexpected failure 502 Bad Gateway - Upstream failure 503 Service Unavailable - Temporary unavailability ``` ### Response Structure ``
- REST Design Principles
- Resource Naming
- HTTP Methods
- Status Codes
- Response Structure
- Pagination
- Filtering & Sorting
- Versioning
- GraphQL Best Practices
- Schema Design
- Query Patterns
- Mutation Patterns
- Rate Limiting
- Authentication
What does the api-design skill do?
RESTful API and GraphQL design best practices. Auto-triggers when designing endpoints, handling HTTP methods, or structuring API responses.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill api-design-bigdegenenergy-ai-dev-toolkit --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.