Does this skill support both REST and GraphQL?

Yes, it provides detailed design patterns and implementation examples for both RESTful resource-oriented architectures and schema-first GraphQL APIs.

Is it compatible with modern frameworks like FastAPI or Apollo?

Yes, the principles and patterns provided are framework-agnostic but include practical implementation examples for modern tools like FastAPI and Ariadne.

Can it help me solve performance issues like the N+1 problem?

Absolutely. It includes specific guidance and code patterns for using DataLoaders in GraphQL to batch requests and prevent inefficient database querying.

How does this help with API versioning?

It outlines multiple strategies for API evolution, including URL, header, and query parameter versioning, helping you manage breaking changes without disrupting clients.

API Design Principles

Name: API Design Principles
Author: amurata

byamurata

•

API 개발

Masters the art of building intuitive, scalable, and maintainable REST and GraphQL APIs using industry-standard patterns and best practices.

This skill empowers developers to architect robust backends by providing comprehensive guidance on RESTful and GraphQL design principles. It covers everything from resource-oriented architecture and HTTP semantics to schema-first GraphQL development and N+1 problem mitigation using DataLoaders. Whether you are establishing team standards, reviewing API specifications before implementation, or refactoring legacy services for a better developer experience, this skill ensures your APIs are professional, consistent, and built to withstand the test of time.

주요 기능

01Schema-first GraphQL development and resolver optimization

02Robust error handling and HTTP status code mapping

03Advanced patterns like HATEOAS and DataLoader for performance

043 GitHub stars

05Standardized RESTful resource and collection design patterns

06Comprehensive API versioning and evolution strategies

사용 사례

01Designing a new high-performance REST or GraphQL backend from scratch

02Refactoring legacy API endpoints to improve usability and developer experience

03Establishing a consistent set of API standards and documentation for engineering teams

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add amurata/cc-tools api-design-principles

For use in Claude.ai and ChatGPT

Download Skill