Does it cover error handling?

Yes, it defines standardized error response structures and the correct usage of HTTP status codes for various failure scenarios.

How does it handle API versioning?

It offers guidance on multiple versioning strategies, including URL-based, header-based, and query parameter versioning to ensure backward compatibility.

Can it help with N+1 performance issues?

Absolutely, it includes specific patterns for implementing DataLoaders to batch requests and optimize GraphQL resolver performance.

Does this skill support both REST and GraphQL?

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

API Design Principles

Name: API Design Principles
Author: carlopezzuto

bycarlopezzuto

API 开发

Architects robust, scalable, and developer-friendly REST and GraphQL APIs using industry-standard patterns and best practices.

关于

This skill provides Claude with expert-level guidance on designing, refactoring, and documenting modern APIs. It covers essential RESTful principles such as resource-oriented architecture and semantic HTTP methods, alongside advanced GraphQL patterns like schema-first design and N+1 prevention with DataLoaders. Whether you are establishing team-wide standards, implementing complex pagination and filtering, or managing API versioning, this skill ensures your backend services remain intuitive and maintainable for long-term growth.

主要功能

Standardized RESTful resource and endpoint design patterns
N+1 problem prevention using DataLoader implementation patterns
Implementation of robust pagination, filtering, and error handling
Advanced GraphQL schema-first development and resolver patterns
API versioning strategies including URL, Header, and Query parameters
0 GitHub stars

使用场景

Migrating services from REST to GraphQL architecture
Designing a new scalable backend API from scratch
Refactoring existing legacy endpoints for better developer experience

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add carlopezzuto/agents api-design-principles

For use in Claude.ai and ChatGPT

Download Skill

GitHub

关于