How does this skill help with GraphQL performance?

It includes specific implementation patterns for the DataLoader utility to prevent common N+1 query problems in complex GraphQL resolvers.

Can I use this for existing API refactoring?

Absolutely. It is designed to help identify action-oriented anti-patterns and guide the transition to more intuitive, resource-oriented designs.

Does it provide code examples for specific frameworks?

The skill provides architectural patterns demonstrated with Python frameworks like FastAPI and Ariadne, but the principles are language-agnostic and applicable to any backend stack.

Does this skill support both REST and GraphQL?

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

API Design Principles

Name: API Design Principles
Author: ai-pilo

byai-pilo

API 开发

Architects standardized REST and GraphQL interfaces using industry-best practices for scalability, maintainability, and developer experience.

关于

This skill empowers Claude to design high-quality backend interfaces by applying rigorous RESTful and GraphQL architectural patterns. It provides detailed guidance on resource-oriented design, schema-first development, and advanced implementation patterns like HATEOAS and DataLoader for N+1 prevention. Whether you are bootstrapping a new microservice, refactoring legacy endpoints, or establishing team-wide API standards, this skill ensures your APIs are intuitive, version-resilient, and optimized for both mobile and third-party integrations.

主要功能

Implements schema-first GraphQL design with Relay-style pagination
Standardizes RESTful resource-oriented architecture and HTTP method semantics
Provides robust, consistent error handling and HTTP status code mapping
Guides multi-strategy API versioning for seamless service evolution
Prevents GraphQL N+1 performance issues using the DataLoader pattern
0 GitHub stars

使用场景

Migrating a legacy backend from REST to a strongly-typed GraphQL schema
Architecting a new microservice API with consistent RESTful conventions
Conducting automated API design reviews to identify usability bottlenecks

关于

主要功能

Implements schema-first GraphQL design with Relay-style pagination
Standardizes RESTful resource-oriented architecture and HTTP method semantics
Provides robust, consistent error handling and HTTP status code mapping
Guides multi-strategy API versioning for seamless service evolution
Prevents GraphQL N+1 performance issues using the DataLoader pattern
0 GitHub stars

使用场景

Migrating a legacy backend from REST to a strongly-typed GraphQL schema
Architecting a new microservice API with consistent RESTful conventions
Conducting automated API design reviews to identify usability bottlenecks