skills/api-design/SKILL.md

---
name: api-design
description: Design clear, secure APIs, webhooks, contracts, errors, pagination, and versioning.
---

# API Design

Define resources, operations, authentication, authorization, validation, request and response schemas, error shapes, idempotency, pagination, rate limits, webhook retries, observability, and compatibility strategy.