Why does this skill recommend cursor-based pagination?

Cursor-based pagination is more stable for frequently changing data and offers significantly better database performance for large datasets compared to offset-based pagination.

Where should I version my API according to these patterns?

The skill recommends versioning in the URL path (e.g., /api/v1/) to ensure easier debugging, better caching, and clear contract boundaries.

Does this skill support specific frameworks like Express or Fastify?

The skill provides framework-agnostic principles and TypeScript patterns that are easily adaptable to any Node.js framework or web technology.

How are error responses structured?

It follows the RFC 7807 'Problem Details for HTTP APIs' standard to ensure consistent, machine-readable, and human-friendly error communication.

API Design Patterns

Name: API Design Patterns
Author: martinffx

bymartinffx

•

API Development

Designs consistent, maintainable REST APIs following industry-standard principles and robust implementation patterns.

About

This skill provides Claude with a comprehensive set of REST API design principles, enabling the creation of production-grade backends with predictable resource naming, RFC 7807 error handling, and high-performance cursor-based pagination. It offers framework-agnostic guidance for building scalable interfaces, covering essential topics such as URL-based versioning strategies, filtering/sorting logic, and the implementation of idempotency keys for safe retries.

Key Features

Standardized RESTful resource naming and nesting conventions
High-performance cursor-based pagination implementation patterns
RFC 7807 compliant error handling and problem detail structures
Idempotency key patterns for safe non-idempotent operations
1 GitHub stars
URL-based API versioning and lifecycle management

Use Cases

Refactoring legacy endpoints to improve consistency and developer experience
Implementing standardized error responses and pagination for high-volume data
Architecting a new REST API for a scalable microservice architecture

About

Key Features

Standardized RESTful resource naming and nesting conventions
High-performance cursor-based pagination implementation patterns
RFC 7807 compliant error handling and problem detail structures
Idempotency key patterns for safe non-idempotent operations
1 GitHub stars
URL-based API versioning and lifecycle management

Use Cases

Refactoring legacy endpoints to improve consistency and developer experience
Implementing standardized error responses and pagination for high-volume data
Architecting a new REST API for a scalable microservice architecture