# API Design

> REST and RPC surface design: resource modelling, idempotency, pagination that survives inserts, error shapes a client can act on, and versioning that does not strand callers.

- Skill: `gulmezeren2-byte/api-design` (Agent Skill)
- Install (CLI): `npx skillmds@latest add gulmezeren2-byte/api-design`
- Raw SKILL.md: https://api.skillmd.com/api/skills/gulmezeren2-byte/api-design/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: gulmezeren2-byte (https://skillmd.com/u/gulmezeren2-byte)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/gulmezeren2-byte/api-design

---


# api-design

REST and RPC surface design: resource modelling, idempotency, pagination that
survives inserts, error shapes a client can act on, and versioning that does
not strand callers.