Does this skill support both REST and GraphQL?

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

Does it cover API versioning?

Yes, it includes best practices for URL, Header, and Query Parameter versioning strategies to help your API evolve gracefully over time.

Can I use this for refactoring existing APIs?

Absolutely. The skill includes patterns for improving usability, updating versioning strategies, and implementing better error handling in legacy systems.

How does it help with GraphQL performance?

It provides patterns for resolver design and specifically addresses the N+1 query problem using DataLoader patterns to batch requests.

API Design Principles

Name: API Design Principles
Author: goodnight000

bygoodnight000

0•

API 开发

Builds and refines intuitive, scalable, and maintainable REST and GraphQL APIs using industry-standard design patterns.

This skill provides comprehensive guidance for architecting high-quality APIs, covering both RESTful and GraphQL paradigms. It assists developers in creating resource-oriented architectures, designing robust schemas, implementing efficient pagination, and handling complex error scenarios. Whether you are building a new backend from scratch, refactoring legacy endpoints for better usability, or establishing team-wide API standards, this skill ensures your interfaces are developer-friendly, performant, and built to stand the test of time using proven patterns like HATEOAS and DataLoaders.

主要功能

01Schema-first GraphQL design patterns and resolver optimization

02Proven strategies for API versioning and N+1 problem prevention

03Comprehensive RESTful resource-oriented architecture guidance

04Advanced pagination, filtering, and HATEOAS patterns

05Standardized error handling and HTTP status code implementation

060 GitHub stars

使用场景

01Migrating a legacy REST API to a modern GraphQL implementation

02Establishing organizational API design standards and reviewing specifications

03Designing a new microservice API with consistent naming and resource structures

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add goodnight000/kittycourt api-design-principles

For use in Claude.ai and ChatGPT

Download Skill