API Designer

Overview

This skill provides comprehensive guidance for designing, documenting, and implementing modern APIs. It covers both REST and GraphQL paradigms, with emphasis on industry best practices, clear documentation, and maintainable architecture. Use this skill to create production-ready API designs that are scalable, secure, and developer-friendly.

Core Capabilities

REST API Design

• Resource-oriented endpoint design with proper URL structure
• HTTP method semantics and status code usage
• Request/response payload design with consistent naming
• Pagination, filtering, and sorting strategies
• Error handling and validation patterns