api-design
REST and GraphQL API design principles — resource modeling, HTTP semantics, pagination, error handling, HATEOAS, schema design, and DataLoader patterns. Use when designing new APIs, reviewing specs, or establishing team API standards.
npx skills add majiayu000/claude-skill-registry --skill api-design-wpank-ai --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 Principles Design intuitive, scalable, and maintainable APIs that delight developers. Covers both REST and GraphQL paradigms with production-ready patterns. ## When to Use This Skill - Designing new REST or GraphQL APIs - Refactoring existing APIs for better usability - Establishing API design standards for a team - Reviewing API specifications before implementation - Migrating between API paradigms (REST ↔ GraphQL) - Optimizing APIs for specific consumers (mobile, third-party) ## Installation ### OpenClaw / Moltbot / Clawbot ```bash npx clawhub@latest install api-design ``` --- ## REST Design Principles ### Resource-Oriented Architecture Resources are nouns, actions are HTTP methods. | Method | Semantics | Idempotent | Safe | |--------|-----------|------------|------| | `GET` | Retrieve resource(s) | Yes | Yes | | `POST` | Create new resource | No | No | | `PUT` | Replace entire resource | Yes | No | | `PATCH` | Partial update | No | No | | `DELETE` | Remove resource | Yes | No | ### Resource Collection Design ``` # Resource-oriented endpoints GET /api/users # List users (paginated) POST /api/users # Create user GET /api/users/{id} # Get specific user PUT /api/users/{
- When to Use This Skill
- Installation
- OpenClaw / Moltbot / Clawbot
- REST Design Principles
- Resource-Oriented Architecture
- Resource Collection Design
- Pagination
- Filtering, Sorting, and Search
- Error Response Format
- Status Code Usage
- HATEOAS
- Idempotency
- GraphQL Design Principles
- Schema-First Development
npx clawhub@latest install api-design
What does the api-design skill do?
REST and GraphQL API design principles — resource modeling, HTTP semantics, pagination, error handling, HATEOAS, schema design, and DataLoader patterns. Use when designing new APIs, reviewing specs, or establishing team API standards.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill api-design-wpank-ai --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.