api-design
Design RESTful APIs following conventions with proper error handling, versioning, and documentation. Use when creating or modifying API endpoints.
npx skills add majiayu000/claude-skill-registry --skill api-design-junior-frontend-dev-hi-u-ng --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 ## Purpose Create consistent, well-designed APIs. ## REST Conventions Reference: [standards/rest-conventions.md](standards/rest-conventions.md) ### HTTP Methods | Method | Use Case | Idempotent | |--------|----------|------------| | GET | Retrieve resource | Yes | | POST | Create resource | No | | PUT | Replace resource | Yes | | PATCH | Partial update | No | | DELETE | Remove resource | Yes | ### URL Patterns ``` GET /users # List users GET /users/:id # Get user POST /users # Create user PUT /users/:id # Replace user PATCH /users/:id # Update user DELETE /users/:id # Delete user GET /users/:id/posts # Nested resource ``` ### Response Status Codes | Code | Meaning | Use When | |------|---------|----------| | 200 | OK | Successful GET, PUT, PATCH | | 201 | Created | Successful POST | | 204 | No Content | Successful DELETE | | 400 | Bad Request | Validation error | | 401 | Unauthorized | Auth required | | 403 | Forbidden | Auth insufficient | | 404 | Not Found | Resource doesn't exist | | 422 | Unprocessable | Business rule violation | | 500 | Server Error | Unexpected error | ## Error Response Format Reference: [standards/error-responses.md](standards/error-respon
- Purpose
- REST Conventions
- HTTP Methods
- URL Patterns
- Response Status Codes
- Error Response Format
- Versioning
- Endpoint Documentation
What does the api-design skill do?
Design RESTful APIs following conventions with proper error handling, versioning, and documentation. Use when creating or modifying API endpoints.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill api-design-junior-frontend-dev-hi-u-ng --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.