What pagination strategy does this skill recommend?

It recommends cursor-based pagination as the default for its stability under concurrent writes and performance at scale, while providing offset-based logic for specific navigation needs.

How does the skill handle API versioning?

It provides a decision framework that defaults to URL path versioning (e.g., /v1/) for its discoverability and ease of testing, but also covers header-based versioning.

What is the recommended error format?

The skill utilizes the RFC 7807 'Problem Details' standard to ensure error responses are consistent, machine-readable, and descriptive across all endpoints.

Does this skill write implementation code for APIs?

No, this skill is focused on design patterns and architecture. For building specific endpoints in frameworks like FastAPI, you should use the corresponding implementation skill.

Does it support authentication guidance?

Yes, it provides patterns for JWT (Bearer tokens), API Keys, OAuth 2.0, and Session Cookies, including security considerations for each.

API Design Strategy

Name: API Design Strategy
Author: AnExiledDev

byAnExiledDev

•

API Development

Standardizes REST API architecture through best-practice guidance on resource naming, versioning, and authentication patterns.

The API Design skill provides a comprehensive framework for architecting robust, scalable, and consumer-centric RESTful interfaces within Claude Code. It enforces a contract-first mental model that prioritizes consistency and predictability, offering detailed guidance on resource-based naming, idempotent HTTP semantics, and modern pagination strategies like cursor-based traversal. By providing clear decision frameworks for versioning strategies and authentication protocols, this skill ensures that developers build APIs that are easy to document, test, and maintain over the long term.

Key Features

01Best-practice authentication patterns for JWT, API Keys, and OAuth 2.0

02Scalable pagination strategies including cursor-based and offset-based patterns

03Comprehensive HTTP method semantics and status code mapping for idempotent design

04RFC 7807 compliant error response structures and token bucket rate limiting guidance

056 GitHub stars

06Standardized resource naming and nesting conventions to avoid verb-based URLs

Use Cases

01Defining a versioning strategy and migration path for an evolving production API

02Standardizing error handling and rate limiting across multiple development teams

03Planning the resource hierarchy and endpoint structure for a new microservice architecture

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add anexileddev/codeforge api-design

For use in Claude.ai and ChatGPT

Download Skill