What languages or frameworks are featured in the examples?

While the principles are universal, the skill includes practical implementation patterns using Python, FastAPI, Pydantic, and Ariadne.

How does it help with API performance?

It includes specific guidance on efficient pagination strategies and advanced techniques like DataLoaders to prevent the common N+1 query problem in GraphQL.

Does this skill support both REST and GraphQL?

Yes, it provides comprehensive design patterns, implementation examples, and best practices for both RESTful and GraphQL API architectures.

Can I use this for existing API projects?

Absolutely. Use this skill to audit current endpoints, refactor for better usability, or plan migrations between API paradigms like moving from REST to GraphQL.

API Design Principles

Name: API Design Principles
Author: drgaciw

bydrgaciw

API Development

Design and implement robust, scalable, and intuitive REST and GraphQL APIs following industry best practices.

About

This skill empowers developers to architect high-quality APIs by providing domain-specific guidance on RESTful resource-oriented architecture and GraphQL schema-first development. It covers critical patterns such as consistent versioning, advanced pagination, structured error handling, and HATEOAS for REST, as well as type-safe schema design and N+1 query prevention using DataLoaders for GraphQL. Whether you are refactoring legacy systems or building modern, developer-friendly backend services from scratch, this skill provides the implementation patterns and standards necessary to build APIs that stand the test of time.

Key Features

GraphQL schema-first development and type-safe query/mutation design
RESTful resource-oriented architecture and HTTP method semantics
Advanced optimization techniques like DataLoaders for N+1 prevention
0 GitHub stars
Consistent error handling patterns and HTTP status code mapping
Standardized API versioning and pagination strategies

Use Cases

Designing new REST or GraphQL APIs for modern web applications
Refactoring existing API specifications for better usability and scalability
Establishing organizational API design standards and documentation

About

Key Features

GraphQL schema-first development and type-safe query/mutation design
RESTful resource-oriented architecture and HTTP method semantics
Advanced optimization techniques like DataLoaders for N+1 prevention
0 GitHub stars
Consistent error handling patterns and HTTP status code mapping
Standardized API versioning and pagination strategies

Use Cases

Designing new REST or GraphQL APIs for modern web applications
Refactoring existing API specifications for better usability and scalability
Establishing organizational API design standards and documentation