Does this skill support both REST and GraphQL?

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

Does it provide code examples for implementation?

Yes, the skill includes practical code patterns using Python and FastAPI for REST, and Ariadne for GraphQL, illustrating how to apply theoretical principles in code.

How does this help with API performance?

The skill includes specific implementation patterns for efficient data fetching, such as pagination and filtering for REST, and the DataLoader pattern to prevent N+1 queries in GraphQL.

Can this skill help with API versioning?

Absolutely. It covers multiple versioning strategies including URL, Header, and Query Parameter versioning to help you manage breaking changes effectively.

API Design Principles

Name: API Design Principles
Author: nguyendinhquocx

bynguyendinhquocx

0•

API Development

Guides the design and implementation of professional REST and GraphQL APIs using industry best practices and patterns.

This skill empowers Claude to act as a senior backend architect, providing expert guidance on creating scalable, maintainable, and developer-friendly APIs. It covers the full spectrum of modern API development, from resource-oriented RESTful architectures and HATEOAS to schema-first GraphQL design and N+1 problem prevention with DataLoaders. Whether you are bootstrapping a new service, refactoring legacy endpoints, or establishing organizational API standards, this skill ensures your interfaces are intuitive, consistent, and built to stand the test of time.

Key Features

010 GitHub stars

02API versioning strategies for long-term maintainability

03N+1 query prevention using DataLoader patterns in GraphQL

04Robust pagination, filtering, and error handling implementations

05Advanced GraphQL schema design and resolver optimization patterns

06Standardized RESTful resource modeling and HTTP method semantics

Use Cases

01Refactoring existing endpoints to improve developer experience and scalability

02Designing a new microservice API from scratch with consistent standards

03Migrating a RESTful service to a GraphQL architecture efficiently

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add nguyendinhquocx/code-ai api-design-principles

For use in Claude.ai and ChatGPT

Key Features

010 GitHub stars

02API versioning strategies for long-term maintainability

03N+1 query prevention using DataLoader patterns in GraphQL

04Robust pagination, filtering, and error handling implementations

05Advanced GraphQL schema design and resolver optimization patterns

06Standardized RESTful resource modeling and HTTP method semantics

Use Cases

01Refactoring existing endpoints to improve developer experience and scalability

02Designing a new microservice API from scratch with consistent standards

03Migrating a RESTful service to a GraphQL architecture efficiently

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add nguyendinhquocx/code-ai api-design-principles

For use in Claude.ai and ChatGPT