How does this skill help with API versioning?

It provides specific implementation strategies for URI, Header, and Query Parameter versioning, including guidance on deprecation headers and sunsetting policies.

Does it cover API security and rate limiting?

Absolutely, it includes best practices for authentication patterns like JWT and API Keys, as well as standard rate limiting headers (RFC 6585).

Is it compatible with OpenAPI standards?

Yes, the patterns are designed to align with OpenAPI specifications and GraphQL Schema definitions to ensure consistent, interactive documentation.

Can it help with both REST and GraphQL?

Yes, it contains patterns for resource-oriented REST design as well as GraphQL query structure, mutation patterns, and error extensions.

What types of pagination are supported?

The skill guides you through choosing and implementing Offset-based, Cursor-based, or Keyset (Seek) pagination based on your dataset size and consistency needs.

API Design Patterns

Name: API Design Patterns
Author: NickCrew

byNickCrew

•

API Development

Standardizes API architecture with production-grade patterns for REST and GraphQL services, covering versioning, pagination, and error handling.

This skill provides Claude with expert-level guidance for designing scalable and maintainable REST and GraphQL APIs using industry-standard implementation patterns. It helps developers architect robust service contracts, implement complex pagination strategies like cursor-based or keyset navigation, and enforce consistent error handling and versioning across microservices. Whether building a backend from scratch or refactoring legacy endpoints, this skill ensures your APIs follow semantic HTTP principles, utilize secure authentication patterns, and optimize performance through field selection and caching strategies.

Key Features

01Standardized error response formatting and semantic HTTP status code mapping.

02Advanced pagination strategies including cursor, offset, and keyset methods.

037 GitHub stars

04Comprehensive REST and GraphQL design patterns for scalable architectures.

05Versioning strategies for URI, header, and query parameter approaches.

06Implementation of idempotency, HATEOAS, and sparse fieldsets for performance.

Use Cases

01Implementing efficient cursor-based pagination for high-performance data feeds.

02Refactoring existing microservices to standardize error handling and authentication.

03Designing a new production-grade REST API with resource-oriented URLs.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add nickcrew/claude-cortex api-design-patterns

For use in Claude.ai and ChatGPT

Download Skill