Does this skill support both REST and GraphQL?

Yes, it provides comprehensive patterns for both RESTful URL structures and GraphQL schema designs, including specific input types and connections.

How does it handle API pagination?

The skill covers standard page/limit pagination for REST and the Relay-style connection/cursor-based pagination for GraphQL.

Can this help with API security?

Yes, it includes best practices for implementing JWT, API Keys, and OAuth 2.0 flows, as well as rate limiting headers.

Is documentation included in the patterns?

Yes, the skill provides patterns for OpenAPI (Swagger) specifications to ensure your APIs are self-documenting and easy for other developers to use.

API Design Patterns

Name: API Design Patterns
Author: drewdresser

bydrewdresser

0•

API Development

Guides the development of high-quality RESTful and GraphQL APIs using industry-standard patterns and architectural best practices.

The API Design Patterns skill equips Claude with specialized knowledge for architecting robust, scalable, and intuitive APIs. It provides comprehensive guidance on resource-based URL structures, idempotent HTTP methods, and semantic status codes for RESTful services. Additionally, it includes sophisticated patterns for GraphQL schema design, connection-based pagination, and secure authentication flows like JWT and OAuth 2.0. Whether you are bootstrapping a new microservice or refactoring an existing backend, this skill ensures that AI-generated code follows modern standards for performance, security, and maintainability.

Key Features

01OpenAPI (Swagger) documentation and security implementation standards

02Comprehensive HTTP status code and structured error response handling

03Advanced filtering, sorting, and cursor-based pagination patterns

040 GitHub stars

05Standardized RESTful resource mapping and HTTP method selection

06GraphQL schema design including mutations, inputs, and connections

Use Cases

01Implementing standardized error handling and rate limiting across backend services

02Designing complex GraphQL schemas for efficient frontend data fetching

03Architecting a new RESTful microservice with consistent naming and versioning

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add drewdresser/ai-dev-settings designing-apis

For use in Claude.ai and ChatGPT

Download Skill