Can it help prevent the GraphQL N+1 problem?

Yes, it includes specific implementation patterns for DataLoaders and batching to optimize resolver performance and reduce database load.

How does this skill help with REST API design?

It provides patterns for resource-oriented architecture, correct HTTP method usage, and standardized collection handling like pagination and filtering.

Is this skill specific to a particular programming language?

While the examples often feature Python and FastAPI, the architectural principles and GraphQL schema definitions are universal and applicable across any backend stack.

Does it cover API versioning strategies?

Absolutely. It outlines multiple industry-standard strategies including URL versioning, header-based versioning, and query parameter versioning.

API Design Principles

Name: API Design Principles
Author: Activer007

byActiver007

•

API 개발

Implements industry-standard REST and GraphQL architectural patterns to build scalable, maintainable, and developer-friendly APIs.

This skill empowers Claude to act as an expert API architect, providing deep guidance on designing both RESTful and GraphQL interfaces. It covers essential patterns including resource-oriented path design, robust versioning strategies, standardized error handling with HTTP status codes, and advanced GraphQL techniques like schema-first development and N+1 resolution using DataLoaders. Whether you are drafting a new API specification, refactoring legacy endpoints, or establishing team-wide design standards, this skill ensures your APIs are intuitive, performant, and built to evolve over time.

주요 기능

01Standardized pagination, filtering, and HATEOAS implementation

02Schema-first GraphQL design with types, queries, and mutations

03Robust error handling and consistent HTTP status code mapping

04Resource-oriented RESTful architecture and HTTP method semantics

058 GitHub stars

06Advanced resolver patterns and N+1 prevention with DataLoaders

사용 사례

01Designing a new microservice API from scratch using REST or GraphQL

02Migrating services from REST to GraphQL or implementing a hybrid approach

03Refactoring existing endpoints to improve developer experience and consistency

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add activer007/ordinary-claude-skills api-design-principles

For use in Claude.ai and ChatGPT

Download Skill