# API Design Implementation

> Group skill: API design and implementation — decision, design, validation, auth, backend, testing, documentation, and monitoring.

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

---


# 🌐 API Design & Implementation

> **Group Skill** — Orchestrates sub-skills for designing and building a new API.
> Activate by saying: "Design an API" or "build a REST API"

## When to Use

- Designing and building a new API
- Need to choose REST vs GraphQL vs tRPC
- Setting up API documentation and monitoring

## Step-by-Step Workflow

### Step 1: Decision
**Skill**: `api-patterns`
- Choose REST vs GraphQL vs tRPC
- Evaluate trade-offs
- Select appropriate protocol

### Step 2: Design
**Skill**: `api-design-principles` / `openapi-spec-generation`
- Define API contracts
- Create OpenAPI/Swagger specs
- Plan versioning strategy

### Step 3: Validation
**Skill**: `zod-validation-expert` / `pydantic-models-py`
- Implement input validation
- Define request/response schemas
- Handle error cases

### Step 4: Auth
**Skill**: `auth-implementation-patterns` / `api-security-best-practices`
- Secure API endpoints
- Implement authentication
- Configure authorization

### Step 5: Backend
**Skill**: `python-fastapi-development` / `nodejs-backend-patterns` / `golang-pro`
- Implement API endpoints
- Connect to data sources
- Handle business logic

### Step 6: Testing
**Skill**: `api-testing-observability-api-mock`
- Write API tests
- Create request mocks
- Test error scenarios

### Step 7: Documentation
**Skill**: `api-documentation` / `api-documentation-generator`
- Generate API docs
- Create usage examples
- Document edge cases

### Step 8: Monitoring
**Skill**: `azure-monitor-opentelemetry-ts` / `prometheus-configuration`
- Set up API observability
- Track latency and errors
- Configure alerting

## Completion

API is designed, built, tested, documented, and monitored. 🌐

## Sub-Skills Referenced

1. `api-patterns`
2. `api-design-principles`
3. `openapi-spec-generation`
4. `zod-validation-expert`
5. `pydantic-models-py`
6. `auth-implementation-patterns`
7. `api-security-best-practices`
8. `python-fastapi-development`
9. `nodejs-backend-patterns`
10. `golang-pro`
11. `api-testing-observability-api-mock`
12. `api-documentation`
13. `api-documentation-generator`
14. `azure-monitor-opentelemetry-ts`
15. `prometheus-configuration`