Does this skill support both REST and GraphQL?

Yes, it provides comprehensive design patterns and implementation examples for both RESTful resource-oriented APIs and GraphQL schema-first architectures.

How does it help with API performance?

It includes specific patterns for efficient pagination, filtering, and the prevention of N+1 query problems using DataLoaders in GraphQL.

Is this skill compatible with FastAPI or other frameworks?

Yes, while the principles are language-agnostic, it provides specific implementation examples using Python and FastAPI for immediate application.

Does it include error handling standards?

Yes, it establishes consistent error response structures and correct HTTP status code usage to improve developer experience and client-side integration.

Can I use this for API versioning?

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

API Design Principles

Name: API Design Principles
Author: HermeticOrmus

byHermeticOrmus

API Development

Implements robust REST and GraphQL architectures with industry-standard design patterns and best practices.

About

The API Design Principles skill empowers Claude to architect intuitive, scalable, and maintainable APIs by applying deep expertise in both REST and GraphQL paradigms. It provides structured guidance on resource-oriented modeling, schema-first development, and efficient data fetching strategies like pagination and batching. Whether you are building a new backend from scratch, refactoring legacy endpoints, or establishing organizational API standards, this skill ensures your interfaces are developer-friendly, performant, and built to stand the test of time.

Key Features

0 GitHub stars
Standardized error handling and HTTP status code mapping
N+1 problem prevention using DataLoader and batching techniques
Advanced pagination and filtering implementation patterns
RESTful resource-oriented architecture design
GraphQL schema-first development and resolver optimization

Use Cases

Migrating legacy monolithic APIs to modern GraphQL schemas
Creating comprehensive, developer-friendly API documentation and specifications
Designing high-performance RESTful microservices with standardized endpoints

About

Key Features

0 GitHub stars
Standardized error handling and HTTP status code mapping
N+1 problem prevention using DataLoader and batching techniques
Advanced pagination and filtering implementation patterns
RESTful resource-oriented architecture design
GraphQL schema-first development and resolver optimization

Use Cases

Migrating legacy monolithic APIs to modern GraphQL schemas
Creating comprehensive, developer-friendly API documentation and specifications
Designing high-performance RESTful microservices with standardized endpoints