How does it help with API performance?

The skill includes specific implementation patterns for efficient pagination and filtering, as well as DataLoaders to prevent the N+1 problem in GraphQL resolvers.

Can I use this for existing API audits?

Absolutely. It is ideal for reviewing existing API specifications or codebases to ensure they meet industry standards for usability, consistency, and maintainability.

Does it cover API versioning strategies?

Yes, it includes detailed strategies for URL, Header, and Query Parameter versioning to help you manage breaking changes and long-term compatibility.

Does this skill support both REST and GraphQL?

Yes, it provides comprehensive patterns and best practices for both RESTful resource-oriented architectures and GraphQL schema-first development.

API Design Principles

Name: API Design Principles
Author: ccf

byccf

0•

API 개발

Architects scalable and intuitive REST and GraphQL interfaces using industry-standard design patterns and best practices.

This skill provides a comprehensive framework for building developer-friendly APIs that are maintainable, scalable, and robust. It guides users through the intricacies of resource-oriented RESTful design, schema-first GraphQL development, and standardized error handling. By implementing these patterns, developers can ensure their backend services provide consistent pagination, efficient data fetching via DataLoaders to prevent N+1 issues, and logical versioning strategies, ultimately creating a seamless integration experience for frontend and third-party consumers.

주요 기능

01Resource-oriented REST architecture and HTTP method mapping

02Schema-first GraphQL design with type-safe mutations

03Standardized error response structures and status codes

040 GitHub stars

05Performance optimization through N+1 prevention and DataLoaders

06Advanced pagination, filtering, and HATEOAS patterns

사용 사례

01Designing a high-performance backend API from scratch

02Refactoring legacy endpoints into consistent, resource-based REST paths

03Establishing organization-wide API design standards and documentation

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ccf/claude-code-ccf-marketplace api-design-principles

For use in Claude.ai and ChatGPT

Download Skill