Design scalable and developer-friendly APIs.
API Design Architect
RESTful APIs, GraphQL, OpenAPI
Best for
- ▸Design RESTful APIs for microservices with proper resource modeling and HTTP semantics
- ▸Create GraphQL schemas with efficient resolver patterns and N+1 problem prevention
- ▸Generate complete OpenAPI 3.1 specifications with authentication schemes and examples
- ▸Design API versioning strategies and backward compatibility migration paths
What you'll get
- ▸Complete REST API specification with resource URIs, HTTP methods, status codes, request/response schemas, and error response format following JSON:API conventions
- ▸GraphQL schema definition with types, queries, mutations, and resolver architecture addressing N+1 problems through batching strategies
- ▸OpenAPI 3.1 YAML specification with security schemes, parameter definitions, example requests/responses, and comprehensive endpoint documentation
Clear business requirements including resources, relationships, user roles, and technical constraints like performance needs or existing system integration points.
Complete API specification with endpoint definitions, request/response schemas, error handling patterns, authentication flows, and OpenAPI documentation ready for implementation.
What's inside
“You are a Senior API Design Architect. You systematically design production-grade, developer-friendly APIs that remain maintainable and stable across years. - You ground decisions in REST architectural constraints (Fielding, 2000), HTTP semantics (RFC 9110-9114), and open standards (OpenAPI 3.1, JSO...”
Covers
Not designed for ↓
- ×Implementation of API code in specific programming languages or frameworks
- ×Database schema design or data modeling beyond API resource representation
- ×DevOps deployment and infrastructure setup for APIs
- ×UI/UX design for developer portals or API documentation websites
SupaScore
89.2▼
Evidence Policy
Standard: no explicit evidence policy.
Research Foundation: 6 sources (1 academic, 4 official docs, 1 books)
This skill was developed through independent research and synthesis. SupaSkills is not affiliated with or endorsed by any cited author or organisation.
Version History
v5.5 distilled from v2 via Claude Sonnet
Pipeline v4: rebuilt with 3 helper skills
Initial version
Works well with
Need more depth?
Specialist skills that go deeper in areas this skill touches.
Common Workflows
Complete API Development Lifecycle
End-to-end API development from design through security hardening, documentation, and performance validation
© 2026 Kill The Dragon GmbH. This skill and its system prompt are protected by copyright. Unauthorised redistribution is prohibited. Terms of Service · Legal Notice