Does this skill support both REST and GraphQL?

Yes, it provides comprehensive patterns and best practices for both RESTful resource-oriented architectures and schema-first GraphQL implementations.

Can it help with API versioning?

Absolutely. It covers multiple strategies including URL versioning, header versioning, and query parameter versioning to ensure long-term maintainability.

How does it handle performance issues like the N+1 problem?

It includes specific implementation patterns for GraphQL DataLoaders to batch requests and optimize backend performance.

Is it compatible with modern web frameworks?

Yes, the skill provides practical code examples using modern frameworks like FastAPI and Pydantic, making it easy to translate principles into production code.

API Design Principles

Name: API Design Principles
Author: HermeticOrmus

byHermeticOrmus

•

API Development

Implements industry-standard REST and GraphQL architectural patterns to build scalable, maintainable, and developer-friendly APIs.

About

This skill empowers Claude to architect high-quality APIs by applying robust design principles for both RESTful and GraphQL services. It provides deep guidance on resource-oriented architecture, semantic HTTP methods, schema-first GraphQL development, and sophisticated patterns like HATEOAS and DataLoader. Whether you are building a new backend from scratch, refactoring legacy endpoints, or establishing organizational API standards, this skill ensures your interfaces are intuitive, versioned correctly, and optimized for both performance and developer experience.

Key Features

Standardized API versioning and documentation strategies
Advanced patterns for pagination, filtering, and error handling
RESTful resource-oriented architecture and endpoint design
GraphQL schema-first development and resolver optimization
N+1 problem prevention using DataLoader implementation patterns
2 GitHub stars

Use Cases

Designing a new microservice API with standardized REST endpoints
Migrating legacy RESTful services to a modern GraphQL schema
Establishing consistent error handling and HATEOAS-compliant response structures

About

Key Features

Standardized API versioning and documentation strategies
Advanced patterns for pagination, filtering, and error handling
RESTful resource-oriented architecture and endpoint design
GraphQL schema-first development and resolver optimization
N+1 problem prevention using DataLoader implementation patterns
2 GitHub stars

Use Cases

Designing a new microservice API with standardized REST endpoints
Migrating legacy RESTful services to a modern GraphQL schema
Establishing consistent error handling and HATEOAS-compliant response structures