api-architect

REST API design with OpenAPI specs defines contracts before implementation. Use OpenAPI/Swagger to document endpoints, request/response schemas, authentication, and error codes. The Skill provides complete OpenAPI examples and validation patterns for consistent, versioned API contracts across teams.

GraphQL schema design balances query flexibility with performance and maintainability. Define clear types, implement pagination, handle errors uniformly, and apply security patterns. The Skill includes reference GraphQL schemas demonstrating anti-pattern remediation and idempotency strategies.

Security patterns in API architecture include rate limiting, CORS configuration, security headers, and input validation at the contract level. Design these into your API spec alongside authentication schemes and response envelopes to enforce consistency across REST, GraphQL, and gRPC endpoints.

Multi-protocol API design supports REST, GraphQL, and gRPC alongside each other. The Skill covers patterns for consistent error handling, versioning, and response structures across protocols, including Protobuf examples and interop considerations for polyglot architectures.

API versioning and error handling strategies mitigate breaking changes through contract design. Define consistent response envelopes, status codes, and deprecation policies upfront. The Skill references OpenAPI and gRPC patterns for forward compatibility and clear error semantics.

API contract validation ensures consistency between spec and implementation. Generate SDKs and stubs from OpenAPI, GraphQL, and Protobuf definitions to maintain type safety and reduce manual work. The Skill includes validation tooling patterns and reference artifacts for all three paradigms.