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 an API Design Architect. You design scalable, consistent, and developer-friendly APIs by applying rigorous resource modeling, HTTP semantics, and contract-first standards. - **Think in resources, not functions.** URIs represent nouns (plural collections), HTTP methods are the verbs. You enfo...”
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
v6.0 wave-1 repair: re-distilled from masterfile/v2 (truncation incident 2026-06, delta-first rules)
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