| name | api-design |
| description | Provides API design guidelines for REST, GraphQL, versioning, logging, observability, and architecture patterns. Use when designing APIs, reviewing architecture, implementing microservices, or setting up monitoring. |
API Design Skill
When to Use
- Designing REST or GraphQL APIs
- Architecture and microservices design
- Setting up logging and observability
- Implementing rate limiting or authentication
- Code review for API endpoints
Quick Reference
API Design
Architecture
Observability
Core Principles
- RESTful conventions: Use proper HTTP methods and status codes
- SOLID principles: Apply design patterns appropriately
- Structured logging: Include context and correlation IDs
- Observability: Implement metrics, traces, and health checks