Can I use this to help with API versioning?

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

Does this skill support both REST and GraphQL?

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

Does it provide code examples for specific frameworks?

Yes, it includes practical implementation examples using popular modern tools like FastAPI for REST and Ariadne for GraphQL.

How does it handle API performance optimization?

The skill includes specific implementation patterns for pagination, filtering, and the use of DataLoaders to prevent common performance bottlenecks like the N+1 problem.

API Design Principles

Name: API Design Principles
Author: HermeticOrmus

byHermeticOrmus

API Development

Masters REST and GraphQL design patterns to create scalable, intuitive, and developer-friendly web APIs.

About

This skill provides a comprehensive framework for architecting robust backend services using both REST and GraphQL paradigms. It guides developers through the implementation of resource-oriented architectures, complex pagination strategies, standardized error handling, and N+1 problem prevention using DataLoaders. Whether you are building a new microservice from scratch or refactoring a legacy interface, this skill ensures your APIs are maintainable, performant, and follow industry best practices for versioning and developer experience.

Key Features

Provides consistent error handling structures and HATEOAS hypermedia links
Implements Relay-style GraphQL schema design and strongly-typed mutations
Automates complex pagination, filtering, and search patterns for large datasets
Prevents N+1 performance issues using efficient DataLoader batching patterns
Standardizes RESTful resource-oriented architecture and HTTP method semantics
0 GitHub stars

Use Cases

Designing new high-performance REST or GraphQL endpoints for web and mobile
Refactoring legacy APIs to improve developer experience and system scalability
Establishing organization-wide standards for API versioning and error reporting

About

Key Features

Provides consistent error handling structures and HATEOAS hypermedia links
Implements Relay-style GraphQL schema design and strongly-typed mutations
Automates complex pagination, filtering, and search patterns for large datasets
Prevents N+1 performance issues using efficient DataLoader batching patterns
Standardizes RESTful resource-oriented architecture and HTTP method semantics
0 GitHub stars

Use Cases

Designing new high-performance REST or GraphQL endpoints for web and mobile
Refactoring legacy APIs to improve developer experience and system scalability
Establishing organization-wide standards for API versioning and error reporting