Does this skill support both REST and GraphQL?

Yes, it provides comprehensive principles and patterns for both RESTful resource-oriented design and GraphQL schema-first development.

Which programming languages are featured?

While the principles are language-agnostic, the skill provides specific implementation examples using Python, FastAPI, and Pydantic.

How does this skill handle API performance?

It includes advanced patterns like the DataLoader for GraphQL to prevent N+1 query problems and efficient pagination and filtering strategies for REST collections.

Can this help with existing APIs?

Absolutely. It includes patterns for refactoring, auditing existing specifications, and migrating between paradigms like REST to GraphQL.

API Design Principles

Name: API Design Principles
Author: Activer007

byActiver007

0•

API Development

Master REST and GraphQL architecture to build scalable, developer-friendly APIs using industry-standard patterns.

This skill provides comprehensive guidance on designing, implementing, and reviewing high-quality APIs using REST and GraphQL paradigms. It covers resource-oriented architecture, semantic HTTP methods, schema-first GraphQL development, and advanced patterns like HATEOAS and DataLoader for N+1 prevention. Ideal for software architects and backend developers, it helps establish team standards, refine existing API specifications, and ensure APIs are intuitive, versioned correctly, and optimized for diverse clients ranging from mobile apps to third-party integrations.

Key Features

01Advanced GraphQL schema design and resolver optimization

02Comprehensive error handling and HTTP status code mapping

03Real-world implementation examples using Python and FastAPI

04Standardized RESTful resource-oriented architecture patterns

05Effective API versioning strategies (URL, Header, Query)

060 GitHub stars

Use Cases

01Reviewing existing API specifications for usability and scalability

02Architecting new REST or GraphQL backends from scratch

03Establishing organizational API standards and best practices

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add activer007/ordinary-claude-skills api-design-principles

For use in Claude.ai and ChatGPT

Download Skill