# API Design

> Design or review API endpoints (REST/GraphQL)

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

---

Design or review the API for: $ARGUMENTS

Steps:
1. Gather requirements from the codebase and any existing API patterns
2. Design endpoints following REST conventions (or GraphQL schema)
3. Define request/response schemas with types
4. Document error responses and status codes
5. Write or update OpenAPI spec if applicable