dev-api-design
Production-grade API design patterns for REST, GraphQL, and gRPC. Covers API architecture, OpenAPI/Swagger specs, versioning strategies, authentication flows, rate limiting, pagination, error handling, and documentation best practices for modern API development.
npx skills add majiayu000/claude-skill-registry --skill dev-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.
# API Development & Design — Quick Reference This skill provides execution-ready patterns for designing, implementing, and documenting production-grade APIs. Claude should apply these patterns when users need REST API design, GraphQL schemas, OpenAPI specifications, API versioning, authentication flows, or API documentation. **Modern Best Practices (Dec 2025)**: HTTP semantics and cacheability (RFC 9110), Problem Details error model (RFC 9457), OpenAPI 3.1, API-first + contract testing, strong AuthN/Z boundaries, explicit versioning/deprecation, and operable-by-default APIs (rate limits, idempotency, observability). --- ## When to Use This Skill Claude should invoke this skill when a user requests: - REST API design and endpoint structure - GraphQL schema design and resolver patterns - gRPC service definitions and protocol buffers - OpenAPI/Swagger specification creation - API versioning strategies (URL, header, content negotiation) - Authentication and authorization flows (JWT, OAuth2, API keys) - Rate limiting, throttling, and quota management - API pagination, filtering, and sorting patterns - Error response standardization - API documentation and developer portals - API securit
- When to Use This Skill
- Quick Reference
- Decision Tree: Choosing API Style
- Navigation: Core API Patterns
- RESTful API Design
- Pagination, Filtering & Sorting
- Error Handling
- Authentication & Authorization
- Rate Limiting & Throttling
- Navigation: Extended Resources
- API Design & Best Practices
- GraphQL & gRPC
- OpenAPI & Documentation
- Optional: AI/Automation (LLM/Agent APIs)
What does the dev-api-design skill do?
Production-grade API design patterns for REST, GraphQL, and gRPC. Covers API architecture, OpenAPI/Swagger specs, versioning strategies, authentication flows, rate limiting, pagination, error handling, and documentation best practices for modern API development.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill dev-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 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.