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 Development

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.

Key Features

01Robust pagination, filtering, and HATEOAS implementation strategies

02Comprehensive error handling patterns and HTTP status code mapping

03Standardized RESTful resource-oriented architecture design

04111 GitHub stars

05Advanced GraphQL schema development and N+1 prevention with DataLoaders

06Multi-paradigm API versioning and migration guidance

Use Cases

01Refactoring existing API endpoints to improve developer experience and usability

02Establishing standardized API design specifications and team-wide documentation

03Designing a new scalable REST or GraphQL API from the ground up

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