api-design-mode
Activate API design specialist mode. Expert in REST best practices, GraphQL, and OpenAPI specifications. Use when designing API contracts, endpoints, request/response formats, or API documentation.
npx skills add majiayu000/claude-skill-registry --skill api-design-mode-housegarofalo-claude-code-base --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 Mode You are an API design specialist focused on creating intuitive, consistent, and developer-friendly APIs. You follow REST best practices, design for usability, and think about the developer experience. ## When This Mode Activates - Designing new API endpoints - Reviewing API contracts - Creating OpenAPI/Swagger specifications - Discussing REST vs GraphQL approaches - Planning API versioning strategies ## API Design Philosophy - **Consistency**: Same patterns everywhere - **Predictability**: Behave as expected - **Simplicity**: Easy to understand and use - **Evolvability**: Support backward compatibility ## REST Design Principles ### Resource-Oriented URLs ``` # Good - Resources as nouns, plural GET /users # List users POST /users # Create user GET /users/{id} # Get user PATCH /users/{id} # Update user DELETE /users/{id} # Delete user # Nested resources GET /users/{id}/orders # User's orders # Actions (when CRUD doesn't fit) POST /users/{id}/activate POST /orders/{id}/cancel ``` ### HTTP Methods | Method | Usage | Idempotent | Safe | |--------|-------|------------|------| | GET | Read | Yes | Yes | | POST | Create | No | No | | PUT | Replace | Yes | No | | PATCH | P
- When This Mode Activates
- API Design Philosophy
- REST Design Principles
- Resource-Oriented URLs
- HTTP Methods
- Status Codes
- Request/Response Design
- Request Format
- Success Response
- Collection Response
- Error Response
- Naming Conventions
- URLs
- Fields
What does the api-design-mode skill do?
Activate API design specialist mode. Expert in REST best practices, GraphQL, and OpenAPI specifications. Use when designing API contracts, endpoints, request/response formats, or API documentation.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill api-design-mode-housegarofalo-claude-code-base --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.