How does it handle API versioning?

It recommends and explains URL path versioning while providing a checklist for breaking vs. non-breaking changes and deprecation strategies.

How does this skill improve my API design process?

It provides Claude with a set of vetted conventions—such as using plural nouns and kebab-case for URLs—to ensure consistency across your entire API surface area.

Can this skill help with API security implementation?

It provides standard patterns for token-based authentication (Bearer tokens and API keys) and role-based authorization logic.

Does it provide guidance on large dataset handling?

Yes, it offers detailed comparisons and implementation logic for both simple offset-based pagination and high-performance cursor-based pagination.

Which programming languages are supported by this skill?

The skill includes generic REST patterns and specific implementation examples for TypeScript (Next.js), Python (Django REST Framework), and Go.

REST API Design Patterns

Name: REST API Design Patterns
Author: saar120

bysaar120

0•

API開発

Provides standardized conventions and best practices for building consistent, developer-friendly RESTful APIs.

This skill equips Claude with a comprehensive framework for designing professional REST APIs, ensuring that newly created endpoints and existing services follow industry-standard best practices. It covers critical aspects of backend architecture including resource naming conventions, semantic HTTP status codes, advanced pagination techniques (offset vs. cursor), and robust error handling. By incorporating these patterns, developers can ensure their APIs are predictable, scalable, and easy for both internal and external consumers to integrate, while also addressing production concerns like rate limiting and versioning.

主な機能

01Semantic HTTP status code mapping for success and error states.

02Implementation patterns for offset-based and cursor-based pagination.

03Standardized response formats for data collections and error details.

04Standardized resource naming using plural nouns and kebab-case URLs.

05Scalable API versioning strategies and deprecation lifecycles.

060 GitHub stars

ユースケース

01Architecting new RESTful backend services from the ground up.

02Refactoring existing API contracts to improve consistency and developer experience.

03Implementing advanced filtering, sorting, and searching for large datasets.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add saar120/skillgate-registry api-design

For use in Claude.ai and ChatGPT

主な機能

01Semantic HTTP status code mapping for success and error states.

02Implementation patterns for offset-based and cursor-based pagination.

03Standardized response formats for data collections and error details.

04Standardized resource naming using plural nouns and kebab-case URLs.

05Scalable API versioning strategies and deprecation lifecycles.

060 GitHub stars

ユースケース

01Architecting new RESTful backend services from the ground up.

02Refactoring existing API contracts to improve consistency and developer experience.

03Implementing advanced filtering, sorting, and searching for large datasets.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add saar120/skillgate-registry api-design

For use in Claude.ai and ChatGPT