# obra-api-design

> REST/GraphQL API design with OpenAPI specs, versioning strategies, and best practices

- Author: MikkohChen
- Repository: Frictionless-Labs/claude-skills
- Version: 20251222045014
- Stars: 1
- Forks: 0
- Last Updated: 2026-02-07
- Source: https://github.com/Frictionless-Labs/claude-skills
- Web: https://mule.run/skillshub/@@Frictionless-Labs/claude-skills~obra-api-design:20251222045014

---

---
name: obra-api-design
description: 'REST/GraphQL API design with OpenAPI specs, versioning strategies, and best practices'
---
# obra-api-design

| Field | Value |
|-------|-------|
| **skill_id** | obra-api-design |
| **skill_name** | API Design |
| **description** | REST/GraphQL API design with OpenAPI specs, versioning strategies, and best practices |
| **repo** | obra |
| **category** | dev |
| **impl_readiness** | 83 |
| **business_value** | 86 |
| **risk_level** | low |
| **role_alignment** | Architect |
| **priority_tier** | TIER-1 |
| **effort_hours** | 0.5 |
| **dependencies** | obra-planning |
| **maturity** | active |
| **lifecycle** | candidate |
| **zip_inclusion** | ZIP-1 |

---

## Purpose

Guides API design following REST/GraphQL best practices, generating OpenAPI specifications, defining versioning strategies, and ensuring consistency.

---

## Domain Alignment

| Aspect | Specification |
|--------|---------------|
| **Primary Use** | API architecture and specification |
| **Target Users** | Backend developers, API architects |
| **Integration Points** | OpenAPI, Swagger, GraphQL schemas |

---

## Triggers

| Trigger Type | Pattern |
|--------------|---------|
| **Implicit** | "API", "endpoint", "REST", "GraphQL" keywords |
| **Explicit** | `@api` prefix |
| **Contextual** | Service integration discussions |

---

## Input/Output

| Direction | Format | Example |
|-----------|--------|---------|
| **Input** | Requirements | "User management API" |
| **Output** | API specification | OpenAPI spec, endpoints, schemas |

---

## Safeguards

| Safeguard | Implementation |
|-----------|----------------|
| **RESTful Compliance** | Validate HTTP verb usage |
| **Versioning Strategy** | Enforce consistent versioning |
| **Schema Validation** | OpenAPI spec lint checks |
| **Breaking Change Detection** | Flag incompatible changes |

---

## Notes

- **Full Slug**: obra/superpowers
- **Source**: ChatGPT A1 Master Catalog audit
- **Batch**: ZIP-1 Batch 3 (Extended Workflow)