Does this skill help with naming conventions?

Yes, it enforces the use of plural nouns and lowercase URLs while avoiding verbs in paths to ensure a clean, resource-based hierarchy.

Does it support modern API features like bulk operations?

Yes, it includes specific design patterns for bulk creation, updates, and asynchronous long-running tasks using 202 Accepted status codes.

Can I use this for designing error handling?

Absolutely. It provides standardized error response formats and maps specific scenarios to the correct HTTP status codes like 400, 422, or 409.

How does it handle deep resource nesting?

The skill recommends limiting nesting to one level (e.g., /users/{id}/orders) and suggests using query parameters for deeper relationships to maintain simplicity.

REST API Designer

Name: REST API Designer
Author: armanzeroeight

byarmanzeroeight

•

API Development

Designs industry-standard RESTful API architectures with consistent resource modeling and optimized endpoint structures.

The REST API Designer skill transforms Claude into a specialized API architect capable of crafting scalable, developer-friendly backend interfaces. It provides a comprehensive framework for resource-based URL modeling, proper HTTP method mapping, and standardized response structures. By following ingrained industry best practices, this skill ensures that your API designs are consistent, maintainable, and easy to document, covering everything from basic CRUD operations to advanced patterns like bulk actions, asynchronous processing, and HATEOAS.

Key Features

01Resource-oriented URL modeling using plural nouns and hierarchical structures

0219 GitHub stars

03Standardized patterns for pagination, filtering, sorting, and field selection

04Comprehensive HTTP status code mapping and consistent error response formatting

05Correct mapping of HTTP methods (GET, POST, PUT, PATCH, DELETE) for idempotent and non-idempotent actions

06Best practices for API versioning, authentication headers, and rate limiting

Use Cases

01Designing complex data relationships and nesting patterns without creating URL bloat

02Architecting a new microservice API from scratch with a focus on resource consistency

03Refactoring legacy 'verb-based' endpoints into modern, REST-compliant structures

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add armanzeroeight/fastagent-plugins rest-api-designer

For use in Claude.ai and ChatGPT

Download Skill