How does it handle API versioning?

It recommends URL path versioning (e.g., /v1/) for its explicitness and cacheability, while providing a clear strategy for deprecation and non-breaking changes.

When should I use Keyset pagination over Offset pagination?

The skill recommends Keyset-based pagination for infinite scrolls and large datasets because it offers consistent performance and remains stable with concurrent inserts.

Does this skill provide guidance on API security?

Yes, it includes patterns for Bearer token-based authentication, API keys, and Resource-level/Role-based authorization logic.

What programming languages does this API design skill support?

The skill provides implementation patterns and examples for TypeScript (Next.js), Python (Django REST Framework), and Go (net/http).

REST API Design

Name: REST API Design
Author: flatrick

byflatrick

0•

API Development

Designs consistent, production-grade REST APIs using industry-standard patterns for resource naming, status codes, and scalability.

The api-design skill empowers Claude to act as a senior backend architect, providing comprehensive guidance on crafting developer-friendly RESTful interfaces. It covers essential foundations such as semantic URL structures and appropriate HTTP method usage, alongside advanced concepts like keyset pagination, filtering, and versioning strategies. By implementing these patterns, developers can ensure their APIs are consistent, secure, and prepared for high-traffic production environments across multiple languages including TypeScript, Python, and Go.

Key Features

01Standardized HTTP status code and error response mapping

020 GitHub stars

03Scalable pagination strategies including Offset and Keyset methods

04Advanced filtering, sorting, and sparse fieldset implementation patterns

05Strategic versioning and rate limiting guidance for public APIs

06Semantic resource naming and URL structure conventions

Use Cases

01Implementing standardized error handling and validation logic across services

02Designing new API contracts for microservices from scratch

03Refactoring legacy endpoints to adhere to modern REST standards

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add flatrick/mdt api-design

For use in Claude.ai and ChatGPT