Can I use this to standardize my team's error handling?

Absolutely. The skill includes standard request/response patterns for single resources, collections, and detailed error objects with unique request IDs.

How does this skill support API-first development?

It provides a structured workflow (Design → Document → Mock → Build) and templates for OpenAPI specs to ensure design precedes implementation.

Which versioning strategies are recommended by this skill?

The skill covers URL path versioning (recommended for major versions), header-based versioning, and query parameter strategies, including deprecation patterns.

Does it support both REST and GraphQL?

Yes, it includes comprehensive patterns for RESTful resource naming and HTTP methods as well as GraphQL type, mutation, and connection design.

API Design Patterns

Name: API Design Patterns
Author: organvm-iv-taxis

byorganvm-iv-taxis

•

API Development

Design robust, developer-friendly APIs using RESTful patterns, GraphQL schemas, and OpenAPI documentation standards.

The API Design Patterns skill provides specialized guidance for architecting high-quality interfaces that are predictable, discoverable, and evolvable. It offers a comprehensive library of best practices covering RESTful resource naming, GraphQL schema design, versioning strategies, and standardized error handling. By implementing an API-first mindset, this skill helps developers generate production-ready OpenAPI specifications, implement advanced pagination and filtering, and establish secure authentication patterns, ensuring a superior developer experience and long-term system maintainability.

Key Features

01OpenAPI/Swagger specification generation and documentation

02Advanced pagination, filtering, and sorting strategies

032 GitHub stars

04Standardized RESTful resource naming and HTTP method mapping

05Comprehensive GraphQL schema design and mutation patterns

06Robust error handling and HTTP status code conventions

Use Cases

01Implementing standardized versioning and rate-limiting for public-facing APIs

02Generating and maintaining production-grade OpenAPI documentation

03Architecting a new microservice API from scratch using API-first principles

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add organvm-iv-taxis/a-i--skills api-design-patterns

For use in Claude.ai and ChatGPT

Download Skill