Does it include error handling standards?

Yes, it implements the RFC 7807 standard for Problem Details in REST and suggests union-typed errors for GraphQL mutations to ensure consistent error reporting.

How does it handle API pagination?

The skill prioritizes cursor-based pagination over offset-based methods to ensure better performance and consistency for large datasets.

Can it help with microservices communication?

Absolutely. It includes patterns for gRPC unary and streaming RPCs, including deadlines, retry policies, and Google's richer error model for internal services.

What API formats does this skill support?

The skill provides comprehensive guidance for REST, GraphQL (including Federation), and gRPC (including streaming and proto3 definitions).

API Design Patterns & Best Practices

Name: API Design Patterns & Best Practices
Author: majiayu000

bymajiayu000

API開発

Enforces professional API standards for REST, GraphQL, and gRPC using contract-first design principles.

概要

This skill provides Claude with a comprehensive framework for designing production-grade APIs that are scalable, maintainable, and developer-friendly. It covers industry-standard protocols including REST with OpenAPI 3.2, GraphQL Federation, and high-performance gRPC streaming. By implementing this skill, Claude can assist in defining robust contracts, managing complex versioning strategies with Sunset headers, ensuring idempotency for POST requests, and standardizing error handling via RFC 7807, making it an essential tool for backend architects and full-stack developers.

主な機能

Cursor-based pagination and RFC 7807 error format implementation
Advanced gRPC patterns for unary, server, and bidirectional streaming
Contract-first design using OpenAPI 3.2 and proto3 specifications
Standardized REST resource naming and HTTP status code mapping
GraphQL schema optimization and N+1 prevention with DataLoaders
0 GitHub stars

ユースケース

Designing a public-facing REST API with built-in idempotency and rate limiting
Defining high-performance internal microservice communication using gRPC
Architecting a federated GraphQL schema for complex frontend data requirements

概要

主な機能

Cursor-based pagination and RFC 7807 error format implementation
Advanced gRPC patterns for unary, server, and bidirectional streaming
Contract-first design using OpenAPI 3.2 and proto3 specifications
Standardized REST resource naming and HTTP status code mapping
GraphQL schema optimization and N+1 prevention with DataLoaders
0 GitHub stars

ユースケース

Designing a public-facing REST API with built-in idempotency and rate limiting
Defining high-performance internal microservice communication using gRPC
Architecting a federated GraphQL schema for complex frontend data requirements