What languages or frameworks are featured in the examples?

While the principles are universal, the skill includes practical implementation patterns using Python, FastAPI, Pydantic, and Ariadne.

How does it help with API performance?

It includes specific guidance on efficient pagination strategies and advanced techniques like DataLoaders to prevent the common N+1 query problem in GraphQL.

Does this skill support both REST and GraphQL?

Yes, it provides comprehensive design patterns, implementation examples, and best practices for both RESTful and GraphQL API architectures.

Can I use this for existing API projects?

Absolutely. Use this skill to audit current endpoints, refactor for better usability, or plan migrations between API paradigms like moving from REST to GraphQL.

API Design Principles

Name: API Design Principles
Author: drgaciw

bydrgaciw

0•

API 개발

Design and implement robust, scalable, and intuitive REST and GraphQL APIs following industry best practices.

This skill empowers developers to architect high-quality APIs by providing domain-specific guidance on RESTful resource-oriented architecture and GraphQL schema-first development. It covers critical patterns such as consistent versioning, advanced pagination, structured error handling, and HATEOAS for REST, as well as type-safe schema design and N+1 query prevention using DataLoaders for GraphQL. Whether you are refactoring legacy systems or building modern, developer-friendly backend services from scratch, this skill provides the implementation patterns and standards necessary to build APIs that stand the test of time.

주요 기능

01GraphQL schema-first development and type-safe query/mutation design

02RESTful resource-oriented architecture and HTTP method semantics

03Advanced optimization techniques like DataLoaders for N+1 prevention

040 GitHub stars

05Consistent error handling patterns and HTTP status code mapping

06Standardized API versioning and pagination strategies

사용 사례

01Designing new REST or GraphQL APIs for modern web applications

02Refactoring existing API specifications for better usability and scalability

03Establishing organizational API design standards and documentation

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add drgaciw/academic-compliance-hub-glm api-design-principles

For use in Claude.ai and ChatGPT

Download Skill