Can this skill help prevent the N+1 problem in GraphQL?

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

Does this skill support both REST and GraphQL?

Yes, it provides comprehensive principles and implementation patterns for both RESTful resource-oriented design and GraphQL schema-first development.

How does this skill help with API versioning?

It covers multiple versioning strategies including URL paths, custom headers, and query parameters to help you maintain backward compatibility.

Are the principles specific to a certain programming language?

While the code examples feature Python and FastAPI, the core design principles are language-agnostic and applicable to Node.js, Go, Java, or any other backend stack.

API Design Principles

Name: API Design Principles
Author: Microck

byMicrock

•

API Development

Master REST and GraphQL API design to build intuitive, scalable, and maintainable services that delight developers.

This skill provides a comprehensive framework for designing professional-grade APIs, covering both RESTful resource-oriented architectures and GraphQL schema-first development. It equips developers with best practices for endpoint structure, HTTP method semantics, pagination patterns, error handling, and sophisticated GraphQL techniques like DataLoader for N+1 prevention. Whether you are building a new microservice from scratch or refactoring a legacy system, this skill helps establish organization-wide standards that ensure your APIs are developer-friendly, performant, and built to stand the test of time.

Key Features

01Comprehensive RESTful patterns for resource-oriented architecture and HTTP semantics.

02Advanced performance patterns including DataLoader for N+1 problem prevention.

03Schema-first GraphQL development strategies including mutations and subscriptions.

04Standardized implementation guides for pagination, filtering, and HATEOAS.

0589 GitHub stars

06Robust error handling frameworks and consistent HTTP status code mapping.

Use Cases

01Designing a new greenfield microservice architecture with REST or GraphQL.

02Refactoring legacy API endpoints to improve usability and documentation.

03Establishing team-wide API design standards for consistent service development.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

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

For use in Claude.ai and ChatGPT

Download Skill