Is this skill limited to a specific programming language?

While the provided patterns use Python and FastAPI as examples, the core design principles and architectural patterns are language-agnostic.

Does this skill support both REST and GraphQL?

Yes, it provides comprehensive guidelines and implementation patterns for both RESTful resource-oriented design and schema-first GraphQL development.

What versioning strategies are covered?

The skill provides guidance on several common strategies, including URL versioning, header-based versioning, and query parameter versioning.

Can it help solve the GraphQL N+1 problem?

Absolutely. It includes specific patterns for implementing DataLoaders to batch and cache requests, significantly improving query performance.

API Design Principles

Name: API Design Principles
Author: HermeticOrmus

byHermeticOrmus

API 开发

Architects intuitive and scalable REST and GraphQL APIs using industry-standard patterns and best practices.

关于

This skill empowers Claude to design, implement, and refactor high-quality APIs that are both developer-friendly and performance-optimized. It covers essential RESTful concepts like resource-oriented architecture and HTTP semantics alongside advanced GraphQL patterns such as schema-first development and N+1 prevention using DataLoaders. By applying this skill, developers can ensure their backend services follow consistent versioning strategies, robust error handling, and efficient pagination methods, making them easier to maintain and scale over time.

主要功能

Provides reusable patterns for pagination, filtering, and HATEOAS
Optimizes GraphQL performance with DataLoader patterns to solve N+1 problems
Standardizes RESTful resource-oriented architecture and HTTP method semantics
Establishes consistent error handling and HTTP status code standards
0 GitHub stars
Implements schema-first GraphQL design with type-safe queries and mutations

使用场景

Refactoring legacy endpoints to improve usability and follow modern design standards
Architecting a new public-facing API with built-in versioning and documentation
Migrating monolithic data structures into a clean, typed GraphQL schema

关于

主要功能

Provides reusable patterns for pagination, filtering, and HATEOAS
Optimizes GraphQL performance with DataLoader patterns to solve N+1 problems
Standardizes RESTful resource-oriented architecture and HTTP method semantics
Establishes consistent error handling and HTTP status code standards
0 GitHub stars
Implements schema-first GraphQL design with type-safe queries and mutations

使用场景

Refactoring legacy endpoints to improve usability and follow modern design standards
Architecting a new public-facing API with built-in versioning and documentation
Migrating monolithic data structures into a clean, typed GraphQL schema