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 Development

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.

Key Features

01Security implementation patterns for JWT, OAuth 2.0, and API keys

02GraphQL schema design including Relay connection patterns and mutations

032 GitHub stars

04OpenAPI/Swagger documentation standards and versioning strategies

05Comprehensive RESTful resource naming and HTTP semantic guidance

06Standardized response formats, error handling, and pagination strategies

Use Cases

01Architecting a new RESTful backend service for a web or mobile application

02Standardizing existing API endpoints with consistent error handling and security headers

03Defining a GraphQL schema for complex, nested data relationships with efficient pagination

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add daffy0208/ai-dev-standards api-designer

For use in Claude.ai and ChatGPT

Download Skill