api-design-patterns/

api-design-patterns

REST API design with resource naming, pagination, versioning, and OpenAPI spec generation

api design patterns rest

Content Preview

---
name: api-design-patterns
description: REST API design with resource naming, pagination, versioning, and OpenAPI spec generation
---

# API Design Patterns

## Resource Naming

- Use plural nouns: `/users`, `/orders`, `/products`
- Nest for relationships: `/users/{id}/orders`
- Max nesting depth: 2 levels. Beyond that, use query params or top-level resources
- Use kebab-case: `/user-profiles`, not `/userProfiles`
- Never put verbs in URLs: `/users/{id}/activate` is wrong, use `POST /users/{i

How to Use

Recommended: Install to project (local)

mkdir -p .claude/skills
curl -o .claude/skills/api-design-patterns.md \
  https://raw.githubusercontent.com/rohitg00/awesome-claude-code-toolkit/main/skills/api-design-patterns/SKILL.md

Skill is scoped to this project only. Add .claude/skills/ to your .gitignoreif you don't want to commit it.

Alternative: Clone full repo

git clone https://github.com/rohitg00/awesome-claude-code-toolkit

Then reference at skills/api-design-patterns/SKILL.md

Related Skills

REST API design patterns including resource naming, status codes, pagination, filtering, error responses, versioning, and rate limiting for production APIs.

api-designapidesignrest

by affaan-m · everything-claude-code

Automating API Testing

This skill automates API endpoint testing, including request generation, validation, and comprehensive test coverage for REST and GraphQL APIs. It is used when the user requests API testing, contract testing, or validation against OpenAPI specifications. The skill analyzes API endpoints and generate

skill-adapterautomating api testing

by jeremylongshore · plugins-plus-skills

Validating API Contracts

This skill validates API contracts using consumer-driven testing and OpenAPI validation. It leverages Pact for consumer-driven contract testing, ensuring that API providers adhere to the expectations of their consumers. It also validates APIs against OpenAPI specifications to guarantee compliance an

skill-adaptervalidating api contracts

by jeremylongshore · plugins-plus-skills

Build apps with the Claude API or Anthropic SDK. TRIGGER when: code imports `anthropic`/`@anthropic-ai/sdk`/`claude_agent_sdk`, or user asks to use Claude API, Anthropic SDKs, or Agent SDK. DO NOT TRIGGER when: code imports `openai`/other AI SDK, general programming, or ML/data-science tasks.

claude-apiclaudeapiai

by Anthropic · anthropic-official-skills