$npx -y skills add SamarthaKV29/antigravity-god-mode --skill api-design-principlesMaster 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.
| 1 | # API Design Principles |
| 2 | |
| 3 | Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers and stand the test of time. |
| 4 | |
| 5 | ## Use this skill when |
| 6 | |
| 7 | - Designing new REST or GraphQL APIs |
| 8 | - Refactoring existing APIs for better usability |
| 9 | - Establishing API design standards for your team |
| 10 | - Reviewing API specifications before implementation |
| 11 | - Migrating between API paradigms (REST to GraphQL, etc.) |
| 12 | - Creating developer-friendly API documentation |
| 13 | - Optimizing APIs for specific use cases (mobile, third-party integrations) |
| 14 | |
| 15 | ## Do not use this skill when |
| 16 | |
| 17 | - You only need implementation guidance for a specific framework |
| 18 | - You are doing infrastructure-only work without API contracts |
| 19 | - You cannot change or version public interfaces |
| 20 | |
| 21 | ## Instructions |
| 22 | |
| 23 | 1. Define consumers, use cases, and constraints. |
| 24 | 2. Choose API style and model resources or types. |
| 25 | 3. Specify errors, versioning, pagination, and auth strategy. |
| 26 | 4. Validate with examples and review for consistency. |
| 27 | |
| 28 | Refer to `resources/implementation-playbook.md` for detailed patterns, checklists, and templates. |
| 29 | |
| 30 | ## Resources |
| 31 | |
| 32 | - `resources/implementation-playbook.md` for detailed patterns, checklists, and templates. |