rest-api-design
RESTful API design principles, versioning, pagination, HATEOAS, and documentation.
npx skills add a5c-ai/babysitter --skill rest-api-design --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.
# REST API Design Skill Expert assistance for designing RESTful APIs following best practices. ## Capabilities - Design resource-oriented APIs - Implement proper HTTP methods and status codes - Configure API versioning strategies - Implement pagination patterns - Design error responses - Apply HATEOAS principles ## Usage Invoke this skill when you need to: - Design new REST APIs - Review existing API design - Implement pagination - Define error handling - Version APIs ## Design Principles ### Resource Naming ``` # Good - nouns, plural GET /api/users GET /api/users/123 GET /api/users/123/posts # Bad - verbs, actions in URL GET /api/getUsers GET /api/users/123/getPosts POST /api/createUser ``` ### HTTP Methods | Method | Usage | Response | |--------|-------|----------| | GET | Read resource | 200 OK | | POST | Create resource | 201 Created | | PUT | Replace resource | 200 OK | | PATCH | Partial update | 200 OK | | DELETE | Remove resource | 204 No Content | ### Pagination Response ```json { "data": [...], "meta": { "page": 1, "limit": 10, "total": 100, "totalPages": 10 }, "links": { "self": "/api/users?page=1", "next": "/api/users?page=2", "prev": null } } ``` ### Error Response ```j
- Capabilities
- Usage
- Design Principles
- Resource Naming
- HTTP Methods
- Pagination Response
- Error Response
- Best Practices
- Target Processes
What does the rest-api-design skill do?
RESTful API design principles, versioning, pagination, HATEOAS, and documentation.
How do I install it?
Run `npx skills add a5c-ai/babysitter --skill rest-api-design --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 a5c-ai/babysitter, a repository with 1,642 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.