Does this skill support both REST and GraphQL?

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

Can it help with API versioning?

Absolutely. It covers multiple strategies including URL versioning, header versioning, and query parameter versioning to ensure long-term maintainability.

How does it handle performance issues like the N+1 problem?

It includes specific implementation patterns for GraphQL DataLoaders to batch requests and optimize backend performance.

Is it compatible with modern web frameworks?

Yes, the skill provides practical code examples using modern frameworks like FastAPI and Pydantic, making it easy to translate principles into production code.

API Design Principles

Name: API Design Principles
Author: HermeticOrmus

byHermeticOrmus

•

API開発

Implements industry-standard REST and GraphQL architectural patterns to build scalable, maintainable, and developer-friendly APIs.

This skill empowers Claude to architect high-quality APIs by applying robust design principles for both RESTful and GraphQL services. It provides deep guidance on resource-oriented architecture, semantic HTTP methods, schema-first GraphQL development, and sophisticated patterns like HATEOAS and DataLoader. Whether you are building a new backend from scratch, refactoring legacy endpoints, or establishing organizational API standards, this skill ensures your interfaces are intuitive, versioned correctly, and optimized for both performance and developer experience.

主な機能

01Standardized API versioning and documentation strategies

02Advanced patterns for pagination, filtering, and error handling

03RESTful resource-oriented architecture and endpoint design

04GraphQL schema-first development and resolver optimization

05N+1 problem prevention using DataLoader implementation patterns

062 GitHub stars

ユースケース

01Designing a new microservice API with standardized REST endpoints

02Migrating legacy RESTful services to a modern GraphQL schema

03Establishing consistent error handling and HATEOAS-compliant response structures

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add hermeticormus/libreuiux-claude-code api-design-principles

For use in Claude.ai and ChatGPT

Download Skill