How does it handle API versioning?

The skill provides guidance on multiple versioning strategies, including URL versioning, Header versioning, and Query Parameter versioning to ensure backward compatibility.

What is the API Design Principles skill?

It is a specialized capability for Claude Code that provides domain-specific guidance, best practices, and implementation patterns for building high-quality REST and GraphQL APIs.

Can it help with GraphQL performance?

Absolutely; it includes specific patterns for implementing DataLoaders to prevent the common N+1 query problem, ensuring efficient data fetching in complex schemas.

When should I use this skill?

Use it when designing new APIs, reviewing API specifications, establishing team-wide design standards, or optimizing existing services for better developer adoption.

API Design Principles

Name: API Design Principles
Author: markky21

bymarkky21

0•

API開発

Master the creation of intuitive, scalable, and maintainable REST and GraphQL APIs using industry-standard design patterns.

This skill provides comprehensive guidance for architecting robust APIs, covering both RESTful resource-oriented design and GraphQL schema-first development. It helps developers establish consistent naming conventions, implement efficient pagination and filtering, manage versioning strategies, and solve complex backend challenges like the N+1 query issue with DataLoaders. Whether you are building a new microservice from scratch or refactoring existing endpoints to improve the developer experience (DX), this skill ensures your API architecture remains performant, predictable, and easy to integrate with.

主な機能

01Advanced GraphQL schema design and resolver implementation

02Production-ready error handling and HTTP status code mapping

030 GitHub stars

04Efficient pagination, filtering, and HATEOAS implementation

05Standardized RESTful resource-oriented architecture patterns

06Strategies for N+1 problem prevention using DataLoaders

ユースケース

01Refactoring legacy endpoints to improve usability and developer experience

02Designing new microservices with consistent and scalable API contracts

03Migrating existing REST services to a unified and strongly-typed GraphQL schema

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add markky21/claude-skills api-design-principles

For use in Claude.ai and ChatGPT

主な機能

01Advanced GraphQL schema design and resolver implementation

02Production-ready error handling and HTTP status code mapping

030 GitHub stars

04Efficient pagination, filtering, and HATEOAS implementation

05Standardized RESTful resource-oriented architecture patterns

06Strategies for N+1 problem prevention using DataLoaders

ユースケース

01Refactoring legacy endpoints to improve usability and developer experience

02Designing new microservices with consistent and scalable API contracts

03Migrating existing REST services to a unified and strongly-typed GraphQL schema

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add markky21/claude-skills api-design-principles

For use in Claude.ai and ChatGPT