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

0•

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.

主な機能

01Implements schema-first GraphQL design with Relay-style pagination

02Standardizes RESTful resource-oriented architecture and HTTP method semantics

03Provides robust, consistent error handling and HTTP status code mapping

04Guides multi-strategy API versioning for seamless service evolution

05Prevents GraphQL N+1 performance issues using the DataLoader pattern

060 GitHub stars

ユースケース

01Migrating a legacy backend from REST to a strongly-typed GraphQL schema

02Architecting a new microservice API with consistent RESTful conventions

03Conducting automated API design reviews to identify usability bottlenecks

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ai-pilo/agents-backend-architecture api-design-principles

For use in Claude.ai and ChatGPT

主な機能

01Implements schema-first GraphQL design with Relay-style pagination

02Standardizes RESTful resource-oriented architecture and HTTP method semantics

03Provides robust, consistent error handling and HTTP status code mapping

04Guides multi-strategy API versioning for seamless service evolution

05Prevents GraphQL N+1 performance issues using the DataLoader pattern

060 GitHub stars

ユースケース

01Migrating a legacy backend from REST to a strongly-typed GraphQL schema

02Architecting a new microservice API with consistent RESTful conventions

03Conducting automated API design reviews to identify usability bottlenecks

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ai-pilo/agents-backend-architecture api-design-principles

For use in Claude.ai and ChatGPT