# API Design

> Enforces REST API best practices

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

**For complete API design guidelines:** Read `${CLAUDE_PLUGIN_ROOT}/.claude-plugin/reference/skills-full/api-design-full.md`