Can I use this for refactoring existing APIs?

Absolutely. The skill is designed to help with refactoring legacy endpoints, improving usability, and establishing better design standards for existing services.

How does it help with GraphQL performance?

It includes specific patterns for N+1 problem prevention using DataLoaders and efficient resolver design to ensure high-performance data fetching.

Does this skill support both REST and GraphQL?

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

Does it provide implementation examples?

Yes, it includes implementation patterns using Python (FastAPI/Ariadne) and standard GraphQL schema definitions to serve as production-ready templates.

API Design Principles

Name: API Design Principles
Author: jh941213

byjh941213

•

API Development

Master REST and GraphQL API design to build intuitive, scalable, and developer-friendly backend services.

This skill empowers developers to architect high-quality APIs by providing expert guidance on RESTful patterns and GraphQL best practices. It assists in everything from resource-oriented architecture and HTTP status code selection to schema-first development and solving the N+1 problem in GraphQL. Whether you are establishing team standards, reviewing specifications, or refactoring legacy endpoints, this skill ensures your API remains maintainable, performant, and delightful for third-party developers.

Key Features

01GraphQL Schema-First design patterns

02Advanced Pagination and Filtering implementation

03N+1 Problem Prevention using DataLoaders

04RESTful Resource-Oriented Architecture guidance

0585 GitHub stars

06Consistent Error Handling and HTTP semantics

Use Cases

01Refactoring legacy endpoints for improved developer experience

02Establishing standardized API documentation and versioning strategies

03Designing new production-grade REST or GraphQL APIs

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jh941213/my-claude-code-asset api-design-principles

For use in Claude.ai and ChatGPT

Download Skill