# api-design

> Claude/Codex skill by [@affaan-m](https://github.com/affaan-m) · 241k stars · Updated 2026-08-18

REST API design patterns including resource naming, status codes, pagination, filtering, error responses, versioning, and rate limiting for production APIs. Use when designing or reviewing REST endpoints, resource names, status codes, pagination, or versioning.

Tags: ai-agents, anthropic, claude, claude-code, developer-tools, llm, mcp, productivity

## Install

```sh
git clone https://github.com/affaan-m/ECC /tmp/ECC && ln -s /tmp/ECC/skills/api-design ~/.claude/skills/api-design
```

## From README

API Design Patterns Conventions and best practices for designing consistent, developer-friendly REST APIs. When to Activate Designing new API endpoints Reviewing existing API contracts Adding pagination, filtering, or sorting Implementing error handling for APIs Planning API versioning strategy Building public or partner-facing APIs Resource Design URL Structure Naming Rules HTTP Methods and Status Codes Method Semantics | Method | Idempotent | Safe | Use For | |--------|-----------|------|---------| | GET | Yes | Yes | Retrieve resources | | POST | No | No | Create resources, trigger actions | | PUT | Yes | No | Full replacement of a resource | | PATCH | No | No | Partial update of a resource | | DELETE | Yes | No | Remove a resource | PATCH can be made idempotent with proper implementation Status Code Reference Common Mistakes Response Format Success Response Collection Response (with Pagination) Error Response Response Envelope Variants Pagination Offset-Based (Simple) Pros: Easy...

## Links

- HTML page: https://omgskills.com/skills/affaan-m/ecc/api-design/
- GitHub: https://github.com/affaan-m/ECC
- Author: [@affaan-m](https://github.com/affaan-m)

## More from this repo

- [article-writing](https://omgskills.com/skills/affaan-m/ecc/article-writing/index.md) — Used to write articles, guides, blog posts, tutorials, newsletter issues, and other long-form content in a distinctive...
   - [@affaan-m](https://github.com/affaan-m) · 241k stars
- [brand-voice](https://omgskills.com/skills/affaan-m/ecc/brand-voice/index.md) — Used to build a source-derived writing style profile from real posts, essays, launch notes, docs, or site copy, then...
   - [@affaan-m](https://github.com/affaan-m) · 241k stars
- [content-engine](https://omgskills.com/skills/affaan-m/ecc/content-engine/index.md) — Used to create platform-native content systems for X, LinkedIn, TikTok, YouTube, newsletters, and repurposed...
   - [@affaan-m](https://github.com/affaan-m) · 241k stars