/rest-api-design
Designs RESTful APIs with proper resource naming, HTTP methods, status codes, and response formats. Use when building new APIs, establishing API conventions, or designing developer-friendly interfaces.
One skill from claude-skills.
shell
$ npx -y skills add secondsky/claude-skills --skill rest-api-design --agent claude-codeInstalls just this skill. Get the whole plugin for auto-invocation.
How it fires
How this skill gets triggered: by you, by Claude, or both.
- Fires itselfClaude auto-loads it when your prompt matches the work.
- You can call itInvoke it directly when you want it.
- Slash command
/rest-api-design
Context preview
The summary Claude sees to decide when to auto-load this skill.
Designs RESTful APIs with proper resource naming, HTTP methods, status codes, and response formats. Use when building new APIs, establishing API conventions, or designing developer-friendly interfaces.
Stats
Stars194
Forks29
LanguageTypeScript
LicenseMIT
Ships with claude-skills
SKILL.md
rest-api-design.SKILL.md
--- name: rest-api-design description: Designs RESTful APIs with proper resource naming, HTTP methods, status codes, and response formats. Use when building new APIs, establishing API conventions, or designing developer-friendly interfaces. license: MIT --- # REST API Design Design RESTful APIs with proper conventions and developer experience. ## Resource Naming ``` # Good - nouns, plural, hierarchical GET /api/users GET /api/users/123 GET /api/users/123/orders POST /api/users PATCH /api/users/123 DELETE /api/users/123 # Bad - verbs, actions in URL GET /api/getUsers POST /api/createUser POST /api/users/123/delete ``` ## HTTP Methods | Method | Purpose | Idempotent | |--------|---------|------------| | GET | Read resource | Yes | | POST | Create resource | No | | PUT | Replace resource | Yes | | PATCH | Partial update | Yes | | DELETE | Remove resource | Yes | ## Status Codes
