How does it help with API security?

It includes a detailed security checklist and specific guidance on implementing JWT Bearer tokens, OAuth 2.0, API keys, and rate-limiting headers.

Does it provide advice on versioning?

Yes, it covers multiple versioning strategies such as URL and Header versioning, offering pros and cons for each to help you design for long-term evolution.

Can it help generate API documentation?

Absolutely. It follows OpenAPI 3.0/Swagger standards to help define schemas, paths, and response objects that are clear and compatible with interactive documentation tools.

Does this skill support both REST and GraphQL?

Yes, it provides comprehensive guidelines and implementation patterns for both RESTful resource design and GraphQL schema modeling, including pagination and error handling for both styles.

When should I use the API Designer skill?

Use it whenever you are creating backend services, defining API contracts between teams, or integrating third-party services that require consistent data handling.

API Designer

Name: API Designer
Author: daffy0208

bydaffy0208

•

API 开发

Designs robust, scalable, and developer-friendly REST and GraphQL APIs following industry-standard patterns and security best practices.

关于

The API Designer skill empowers Claude to architect production-ready backend interfaces by providing deep expertise in resource naming, endpoint semantics, and schema modeling. It ensures that your APIs are built with a focus on developer experience, security, and long-term evolution. Whether you are defining new RESTful contracts, implementing GraphQL connections, or documenting services with OpenAPI, this skill provides the architectural guardrails and implementation patterns necessary to build high-quality, maintainable backend services.

主要功能

Security implementation patterns for JWT, OAuth 2.0, and API keys
GraphQL schema design including Relay connection patterns and mutations
2 GitHub stars
OpenAPI/Swagger documentation standards and versioning strategies
Comprehensive RESTful resource naming and HTTP semantic guidance
Standardized response formats, error handling, and pagination strategies

使用场景

Architecting a new RESTful backend service for a web or mobile application
Standardizing existing API endpoints with consistent error handling and security headers
Defining a GraphQL schema for complex, nested data relationships with efficient pagination

关于

主要功能

Security implementation patterns for JWT, OAuth 2.0, and API keys
GraphQL schema design including Relay connection patterns and mutations
2 GitHub stars
OpenAPI/Swagger documentation standards and versioning strategies
Comprehensive RESTful resource naming and HTTP semantic guidance
Standardized response formats, error handling, and pagination strategies

使用场景

Architecting a new RESTful backend service for a web or mobile application
Standardizing existing API endpoints with consistent error handling and security headers
Defining a GraphQL schema for complex, nested data relationships with efficient pagination