What versioning strategies are included?

It covers URL versioning, Header versioning, and Query Parameter versioning to help you manage API lifecycles effectively.

How does it handle GraphQL performance issues?

The skill provides specific implementation patterns for N+1 problem prevention using DataLoaders and optimized resolver design.

Does this skill support both REST and GraphQL?

Yes, it provides comprehensive principles and patterns for both RESTful resource-oriented architectures and GraphQL schema-first designs.

Can I use this for existing API refactoring?

Absolutely. It includes patterns for refactoring action-oriented endpoints into resource-oriented ones and improving overall API usability.

API Design Principles

Name: API Design Principles
Author: amurata

byamurata

•

API 개발

Architects intuitive, scalable, and maintainable REST and GraphQL APIs using industry-standard patterns and best practices.

This skill empowers developers to build high-quality backend interfaces by providing comprehensive guidance on both RESTful and GraphQL design paradigms. It covers essential concepts such as resource-oriented architecture, schema-first development, and consistent versioning strategies. With detailed implementation patterns for pagination, robust error handling, and N+1 problem prevention via DataLoaders, this skill ensures your APIs are developer-friendly, performant, and capable of evolving over time. It is an ideal companion for designing new services, refactoring legacy endpoints, or establishing organizational API standards.

주요 기능

01Advanced patterns for pagination, filtering, and HATEOAS

02Robust error handling and HTTP status code mapping

03Standardized RESTful resource-oriented architecture patterns

04Comprehensive API versioning and lifecycle strategies

05GraphQL schema-first design and query optimization

063 GitHub stars

사용 사례

01Refactoring existing endpoints to improve developer experience and usability

02Designing a new greenfield REST or GraphQL API from scratch

03Establishing a consistent API style guide for cross-team development

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