API design (professional)

Skill text is English; answer in the user’s preferred language when rules or the conversation specify it.

Use official HTTP Semantics RFC 9110, OpenAPI Specification, and JSON Schema for standards truth; this skill encodes contract-first design, resource and action modeling, evolution safety, and operationally practical API conventions. Confirm API style (REST/RPC/event), client ecosystem, and compatibility constraints from the project.

Boundary

api-design-pro owns contract shape, resource/action model, mutation and query semantics, versioning, pagination, error/idempotency/retry story, workflow-oriented endpoints, async and webhook patterns at the design level, and integration maps to other skills. It does not replace nestjs-pro / nextjs-pro for framework wiring, graphql-pro for GraphQL-only schema work, or security-pro for full threat modeling — pair as needed.

Related skills (this repo)

Skill	When to combine
`security-pro`	Validate auth, data exposure, abuse paths, and sensitive endpoint hardening.
`testing-pro`	Add contract, integration, and regression tests for API behavior over time.
`graphql-pro`	GraphQL schema, resolvers, and errors vs HTTP mapping.
`deployment-pro`	Rollouts, mixed versions during deploy — client behavior.