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

0•

API Development

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.

Key Features

01Standardized RESTful resource and endpoint design patterns

02N+1 problem prevention using DataLoader implementation patterns

03Implementation of robust pagination, filtering, and error handling

04Advanced GraphQL schema-first development and resolver patterns

05API versioning strategies including URL, Header, and Query parameters

060 GitHub stars

Use Cases

01Migrating services from REST to GraphQL architecture

02Designing a new scalable backend API from scratch

03Refactoring 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