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.

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

01Standardized RESTful resource naming and nesting conventions

02High-performance cursor-based pagination implementation patterns

03RFC 7807 compliant error handling and problem detail structures

04Idempotency key patterns for safe non-idempotent operations

051 GitHub stars

06URL-based API versioning and lifecycle management

Use Cases

01Refactoring legacy endpoints to improve consistency and developer experience

02Implementing standardized error responses and pagination for high-volume data

03Architecting a new REST API for a scalable microservice architecture

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add martinffx/claude-code-atelier api-design

For use in Claude.ai and ChatGPT

Download Skill