api-design-patterns

Enforce consistent API design frameworks across REST, GraphQL, and OpenAPI specifications.

6|1|Updated Apr 7, 2026
One-click install
npx skills add https://github.com/kmshihab7878/claude-code-setup --skill api-design-patterns-kmshihab7878
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: api-design-patterns
Source: https://github.com/kmshihab7878/claude-code-setup/tree/main/skills/api-design-patterns
Command: npx skills add https://github.com/kmshihab7878/claude-code-setup --skill api-design-patterns-kmshihab7878

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Resolve API design drift by enforcing a consistent API design framework.

Core Features & Use Cases

  • Enforces standardized error envelopes, validation, and status codes across all endpoints.
  • Provides guidelines for pagination, versioning, rate limiting, and clear resource naming.
  • Supports review and construction of OpenAPI specifications aligned with best practices.

Quick Start

Write an OpenAPI spec for a new REST endpoint that returns a paginated list of items with proper error handling and rate limiting.

Frequently Asked Questions about api-design-patterns

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enforce consistent API design patterns across multiple projects?

You can enforce consistent API design patterns by applying a standardized framework that resolves design drift across REST and GraphQL endpoints. This approach ensures uniform error envelopes, pagination, status codes, and versioning for all internal services.

What is the best way to standardize error envelopes and status codes in REST APIs?

The best way to standardize error envelopes and status codes is to apply a consistent API design framework across all endpoints. This enforces uniform error handling, validation, and status code usage, eliminating inconsistencies across different internal services.

How do I write an OpenAPI spec for a paginated REST endpoint with rate limiting?

To write an OpenAPI spec for a paginated REST endpoint, follow standardized guidelines for pagination, rate limiting, and resource naming. This ensures your specification aligns with best practices and includes proper error handling.

Does this API design framework support both REST and GraphQL endpoints?

Yes, this API design framework fully supports both REST and GraphQL endpoints. It enforces consistent design patterns, including standardized error envelopes and validation, across multiple projects and internal services.

Why do I need mandatory OpenAPI documentation for internal services?

Mandatory OpenAPI documentation is needed to resolve API design drift and enforce a consistent design framework. It ensures all endpoints adhere to standardized error envelopes, pagination, and rate limiting guidelines across multiple projects.

What are the limitations of enforcing a single API design framework across services?

A limitation of enforcing a single API design framework is the rigidity it introduces when adapting diverse internal services. While it standardizes error envelopes and pagination, teams must align all existing REST and GraphQL patterns to fit the required specifications.