What is the difference between offset and cursor pagination in this skill?

The skill guides you on using offset pagination for simple datasets and admin dashboards, while recommending cursor-based pagination for high-scale feeds and infinite scroll to ensure performance.

Does it include guidance for API security?

Yes, it covers authentication patterns including Bearer tokens and API keys, as well as authorization strategies like resource-level ownership and RBAC.

When should I activate the api-design skill?

Activate it whenever you are designing new API contracts, reviewing existing codebases, or planning long-term versioning and rate-limiting strategies.

How does this skill improve API development?

It provides a standardized framework for naming resources, handling errors, and structuring responses, ensuring your API remains consistent, predictable, and developer-friendly.

Which programming languages are supported?

While the design principles are universal, the skill includes specific implementation patterns for TypeScript (Next.js), Python (Django REST Framework), and Go.

REST API Design Patterns

Name: REST API Design Patterns
Author: flatrick

byflatrick

0•

Desarrollo de API

Standardizes REST API architecture through proven patterns for resource naming, status codes, pagination, and versioning.

The api-design skill provides Claude with a comprehensive framework for building production-grade RESTful APIs. It moves beyond basic CRUD to offer sophisticated guidance on resource naming conventions, semantic HTTP status code usage, and scalable pagination strategies like cursor-based navigation. By implementing these domain-specific best practices, developers can ensure their APIs are developer-friendly, consistent, and maintainable. The skill includes concrete implementation patterns for modern frameworks in TypeScript, Python, and Go, making it an essential companion for backend architecture and code reviews.

Características Principales

01Semantic HTTP method and status code mapping

02Consistent error response and success envelope structures

03Advanced pagination strategies (Offset vs. Cursor-based)

04API versioning and deprecation lifecycle management

05Standardized URL structure and resource naming conventions

060 GitHub stars

Casos de Uso

01Refactoring inconsistent legacy API endpoints to modern standards

02Implementing advanced filtering, sorting, and full-text search

03Architecting a new set of public-facing microservices

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add flatrick/mdt api-design

For use in Claude.ai and ChatGPT