Does this skill support both REST and GraphQL?

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

Can I use this to establish team standards?

Absolutely. This skill is designed to help teams define and implement consistent API design standards across their entire organization.

Does it cover API versioning?

Yes, the skill outlines multiple versioning strategies—including URL, Header, and Query parameter versioning—to help you manage API evolution safely.

How does it help with API performance?

It includes implementation patterns for efficient pagination, filtering, and the use of DataLoaders to prevent common backend performance issues like the N+1 query problem.

API Design Principles

Name: API Design Principles
Author: HermeticOrmus

byHermeticOrmus

API 开发

Provides expert guidance and implementation patterns for building intuitive, scalable, and professional-grade REST and GraphQL APIs.

关于

This skill empowers Claude to act as a senior API architect, offering deep expertise in designing maintainable and developer-friendly interfaces. It covers essential patterns for both RESTful resource-oriented architectures and GraphQL schema-first development, including advanced topics like HATEOAS, Relay-style pagination, and N+1 prevention with DataLoaders. Whether you are architecting a new backend from scratch, refactoring legacy endpoints for better usability, or establishing team-wide API standards, this skill ensures your services follow industry best practices for performance and longevity.

主要功能

RESTful resource-oriented design and HTTP method semantics
GraphQL schema-first development and type-safe mutations
Standardized error handling and consistent HTTP status code mapping
Comprehensive API versioning strategies (URL, Header, and Query)
Advanced patterns for pagination, filtering, and N+1 query prevention
0 GitHub stars

使用场景

Architecting a new backend service using REST or GraphQL best practices
Conducting peer reviews of API specifications to ensure consistency and usability
Migrating legacy endpoints to modern API design standards for better DX

关于

主要功能

RESTful resource-oriented design and HTTP method semantics
GraphQL schema-first development and type-safe mutations
Standardized error handling and consistent HTTP status code mapping
Comprehensive API versioning strategies (URL, Header, and Query)
Advanced patterns for pagination, filtering, and N+1 query prevention
0 GitHub stars

使用场景

Architecting a new backend service using REST or GraphQL best practices
Conducting peer reviews of API specifications to ensure consistency and usability
Migrating legacy endpoints to modern API design standards for better DX