api-design-expert
Expert-level API design principles, REST, GraphQL, versioning, and API best practices
npx skills add majiayu000/claude-skill-registry --skill api-design-expert --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 Expert Expert guidance for API design, RESTful principles, GraphQL, versioning strategies, and API best practices. ## Core Concepts ### API Design Principles - RESTful architecture - Resource-oriented design - Uniform interface - Statelessness - Cacheability - Layered system ### API Styles - REST (Representational State Transfer) - GraphQL - RPC (Remote Procedure Call) - WebSocket - Server-Sent Events (SSE) - gRPC ### Key Considerations - Versioning strategies - Authentication and authorization - Rate limiting - Error handling - Documentation - Backward compatibility ## REST API Design ```python from fastapi import FastAPI, HTTPException, Query, Path, Header from pydantic import BaseModel, Field from typing import List, Optional from datetime import datetime from enum import Enum app = FastAPI( title="User Management API", version="1.0.0", description="RESTful API for user management" ) # Models class UserRole(str, Enum): ADMIN = "admin" USER = "user" GUEST = "guest" class UserCreate(BaseModel): email: str = Field(..., example="user@example.com") name: str = Field(..., min_length=1, max_length=100) role: UserRole = UserRole.USER class UserResponse(BaseModel): id: str e
- Core Concepts
- API Design Principles
- API Styles
- Key Considerations
- REST API Design
- API Versioning
- Error Handling
- Rate Limiting
- HATEOAS Implementation
- API Security
- Best Practices
- Design
- Documentation
- Performance
What does the api-design-expert skill do?
Expert-level API design principles, REST, GraphQL, versioning, and API best practices
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill api-design-expert --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.