Can I use this to establish internal team standards?

Absolutely. It is designed to help you define, review, and document consistent API design standards that improve collaboration and developer experience across your team.

Can this skill help me migrate from REST to GraphQL?

Yes, it provides design patterns and schema mapping strategies to help you transition smoothly between different API paradigms while maintaining architectural integrity.

Does it include code examples for specific frameworks?

The skill features practical implementation patterns using popular modern tools like FastAPI for REST and Ariadne/aiodataloader for GraphQL.

How does it address API performance issues?

It includes specific technical techniques like the DataLoader pattern to prevent N+1 query problems in GraphQL and efficient cursor-based pagination for REST.

API Design Principles

Name: API Design Principles
Author: Microck

byMicrock

•

111

API開発

Master REST and GraphQL API design to build scalable, maintainable, and developer-friendly interfaces.

概要

This skill equips Claude with advanced knowledge of API design best practices, covering both RESTful architectures and GraphQL schemas. It assists developers in creating intuitive resource-oriented endpoints, implementing robust pagination and filtering, managing complex error handling, and optimizing GraphQL queries to prevent N+1 performance issues. Whether you are building a new API from scratch, refactoring legacy services, or establishing team-wide design standards, this skill provides the patterns and implementation examples needed to build high-quality, professional backend services that stand the test of time.

主な機能

Robust pagination, filtering, and HATEOAS implementation strategies
Comprehensive error handling patterns and HTTP status code mapping
Standardized RESTful resource-oriented architecture design
111 GitHub stars
Advanced GraphQL schema development and N+1 prevention with DataLoaders
Multi-paradigm API versioning and migration guidance

ユースケース

Refactoring existing API endpoints to improve developer experience and usability
Establishing standardized API design specifications and team-wide documentation
Designing a new scalable REST or GraphQL API from the ground up

概要

主な機能

Robust pagination, filtering, and HATEOAS implementation strategies
Comprehensive error handling patterns and HTTP status code mapping
Standardized RESTful resource-oriented architecture design
111 GitHub stars
Advanced GraphQL schema development and N+1 prevention with DataLoaders
Multi-paradigm API versioning and migration guidance

ユースケース

Refactoring existing API endpoints to improve developer experience and usability
Establishing standardized API design specifications and team-wide documentation
Designing a new scalable REST or GraphQL API from the ground up