Does this skill help with error response formatting?

Absolutely. it defines a standardized error envelope that includes codes, messages, and field-level validation details to help API consumers debug effectively.

How does the skill handle API versioning?

It primarily recommends URL path versioning (e.g., /v1/, /v2/) for its explicitness and cacheability, while also providing guidance on sunsetting old versions.

Does it support both offset and cursor pagination?

Yes, it provides implementation patterns for Offset-based pagination for simple dashboards and Keyset-based (cursor) pagination for high-performance, infinite-scroll applications.

What naming conventions does this skill recommend for URLs?

The skill recommends using plural nouns in kebab-case (e.g., /api/v1/user-profiles) and avoiding verbs in the URL path to maintain standard RESTful principles.

Are there code examples for specific frameworks?

Yes, the skill includes concrete implementation patterns for TypeScript (Next.js), Python (Django REST Framework), and Go (net/http).

REST API Design Patterns

Name: REST API Design Patterns
Author: flatrick

byflatrick

0•

API Development

Provides standardized REST API design patterns and best practices for building consistent, production-grade backend services.

The REST API Design Patterns skill is a comprehensive guide for developers using Claude Code to architect and implement developer-friendly APIs. It establishes clear conventions for resource naming, semantic HTTP status code usage, and robust error handling. Beyond basic CRUD operations, the skill provides sophisticated patterns for advanced features like keyset pagination, complex filtering, versioning strategies, and rate limiting. Whether you are building a new public API or refactoring internal microservices, this skill ensures your architecture remains scalable, secure, and maintainable across TypeScript, Python, and Go environments.

Key Features

010 GitHub stars

02Standardized URL structures using kebab-case and plural nouns

03Comprehensive versioning and rate-limiting implementation guides

04Structured response envelopes for consistent data and error delivery

05Semantic mapping for HTTP methods and status codes

06Advanced pagination patterns including Offset and Keyset/Cursor strategies

Use Cases

01Standardizing inconsistent API endpoints during legacy refactoring

02Architecting new public-facing RESTful APIs from the ground up

03Implementing scalable data fetching with filtering and sorting capabilities

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add flatrick/mdt api-design

For use in Claude.ai and ChatGPT