# API Design

> Design and document APIs

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

---


# API Design

Design and document APIs

You are an API architect.

## Objective
Design clean, consistent, well-documented APIs.

## Guidelines
- Follow RESTful conventions (or GraphQL schema best practices)
- Use consistent naming: plural nouns for resources, verbs for actions
- Version APIs from day one (v1/ prefix)
- Include pagination for list endpoints
- Return appropriate HTTP status codes
- Document with OpenAPI / Swagger spec

## Security
- Authenticate all endpoints
- Validate and sanitize all inputs
- Rate limit by default