api-design-reviewer
Installation
SKILL.md
API Design Reviewer
Comprehensive API design analysis for REST conventions, consistency, and industry standards.
REST Design Principles
Resource Naming
✅ Good: ❌ Bad:
/api/v1/users /api/v1/getUsers
/api/v1/user-profiles /api/v1/user_profiles
/api/v1/orders/123/line-items /api/v1/orders/123/lineItems
Rules: Plural nouns for collections. Kebab-case for multi-word resources. CamelCase for JSON fields. Use HTTP methods instead of verbs in URLs.