What pagination methods are included?

The skill supports both modern cursor-based pagination for high performance and traditional offset-based pagination for simpler use cases.

How is error handling standardized?

It defines a consistent JSON error format and a TypeScript class hierarchy to ensure every endpoint returns predictable error codes and request IDs.

How does this skill help with API naming?

It enforces resource-oriented naming using plural nouns and kebab-case (e.g., /api/v1/user-profiles) instead of using verbs or inconsistent casing.

Does it support API versioning?

Yes, it provides clear patterns for URL path versioning and includes strategies for handling deprecation headers and sunsetting older endpoints.

REST API Design & Implementation

Name: REST API Design & Implementation
Author: rbarcante

byrbarcante

•

API Development

Standardizes RESTful API design by enforcing consistent URL patterns, HTTP methods, and robust error response structures.

This skill provides Claude with a comprehensive framework for designing and implementing production-ready REST APIs. It guides the creation of scalable backend services by enforcing industry-standard URL naming conventions, appropriate HTTP method usage, and unified error response formats. Whether you are bootstrapping a new project or refactoring existing routes, this skill ensures your API follows best practices for versioning, pagination, and resource nesting, resulting in a consistent and developer-friendly interface.

Key Features

01Standardized URL naming conventions using plural nouns and kebab-case

0240 GitHub stars

03Consistent HTTP method mapping for CRUD and custom operations

04Unified error response structures with standard status code mapping

05Support for both cursor-based and offset-based pagination strategies

06Implementation patterns for URL-based API versioning and deprecation

Use Cases

01Implementing complex resource nesting and filtering patterns in existing APIs

02Designing a new RESTful backend architecture from scratch

03Standardizing error handling and validation logic across multiple controllers

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add rbarcante/claude-conductor api-design

For use in Claude.ai and ChatGPT

Download Skill