# Skill: api-design-principles

> Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers. Use when designing new APIs, reviewing API specifications, or establishing API design standards.

*Digest only: full text not redistributed here.*

## Outline
- When to Use This Skill
- Core Concepts
- 1. RESTful Design Principles
- 2. GraphQL Design Principles
- 3. API Versioning Strategies
- Detailed patterns and worked examples
- Best Practices
- REST APIs
- GraphQL APIs
- Common Pitfalls