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

API 开发

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.

主要功能

0 GitHub stars
API versioning strategies for long-term maintainability
N+1 query prevention using DataLoader patterns in GraphQL
Robust pagination, filtering, and error handling implementations
Advanced GraphQL schema design and resolver optimization patterns
Standardized RESTful resource modeling and HTTP method semantics

使用场景

Refactoring existing endpoints to improve developer experience and scalability
Designing a new microservice API from scratch with consistent standards
Migrating 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

Download Skill

GitHub

关于