How does this skill address API performance?

It includes specific patterns for performance optimization, such as using DataLoaders to solve the N+1 query problem and implementing efficient pagination strategies.

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.

What coding languages are featured in the examples?

The skill provides practical implementation examples primarily using Python with frameworks like FastAPI, Pydantic, and Ariadne for GraphQL.

Does it cover API versioning?

Yes, it outlines multiple versioning strategies including URL-based, header-based, and query parameter-based versioning to help you manage breaking changes.

API Design Principles

Name: API Design Principles
Author: as4584

byas4584

0•

API Development

Architects intuitive and scalable REST and GraphQL interfaces using industry-standard patterns for pagination, error handling, and resource management.

This skill provides a comprehensive framework for designing high-quality APIs that are easy for developers to consume and maintain over time. It covers both RESTful resource-oriented architecture and GraphQL schema-first development, offering concrete implementation patterns for complex requirements like Relay-style pagination, N+1 query prevention with DataLoaders, and HATEOAS. By establishing clear standards for HTTP status codes, versioning strategies, and error responses, this skill helps backend teams build consistent, professional-grade services that stand the test of time.

Key Features

01Performance optimization patterns like N+1 prevention using DataLoaders.

02Comprehensive RESTful patterns for resource-oriented architecture and HTTP semantics.

030 GitHub stars

04GraphQL schema-first design including types, mutations, and subscriptions.

05Robust error handling standards with consistent status codes and response structures.

06Advanced pagination strategies for both REST and Relay-style GraphQL connections.

Use Cases

01Establishing organizational API standards and documentation guidelines.

02Refactoring legacy endpoints to improve developer experience and consistency.

03Designing a new production-grade API for a web or mobile application.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add as4584/antigravity-skills api-design-principles

For use in Claude.ai and ChatGPT

Download Skill