# API Design

> Enforces REST API best practices

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

---


# API Design Skill

**Checks:**
- HTTP methods correct (GET/POST/PUT/DELETE)
- DTOs only (NO entities)
- RESTful names (/users not /getUsers)
- Status codes (200/201/204/400/404)
- @Valid on request bodies
- Error handling
- Auth on protected endpoints

`Read .claude/reference/skills-full/api-design-full.md`