aa71e76eb9
- Add date_added to all 950+ skills for complete tracking - Update version to 6.5.0 in package.json and README - Regenerate all indexes and catalog - Sync all generated files Features from merged PR #150: - Stars/Upvotes system for community-driven discovery - Auto-update mechanism via START_APP.bat - Interactive Prompt Builder - Date tracking badges - Smart auto-categorization All skills validated and indexed. Made-with: Cursor
41 lines
1.5 KiB
Markdown
41 lines
1.5 KiB
Markdown
---
|
|
name: api-design-principles
|
|
description: "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..."
|
|
risk: unknown
|
|
source: community
|
|
date_added: "2026-02-27"
|
|
---
|
|
|
|
# API Design Principles
|
|
|
|
Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers and stand the test of time.
|
|
|
|
## Use this skill when
|
|
|
|
- Designing new REST or GraphQL APIs
|
|
- Refactoring existing APIs for better usability
|
|
- Establishing API design standards for your team
|
|
- Reviewing API specifications before implementation
|
|
- Migrating between API paradigms (REST to GraphQL, etc.)
|
|
- Creating developer-friendly API documentation
|
|
- Optimizing APIs for specific use cases (mobile, third-party integrations)
|
|
|
|
## Do not use this skill when
|
|
|
|
- You only need implementation guidance for a specific framework
|
|
- You are doing infrastructure-only work without API contracts
|
|
- You cannot change or version public interfaces
|
|
|
|
## Instructions
|
|
|
|
1. Define consumers, use cases, and constraints.
|
|
2. Choose API style and model resources or types.
|
|
3. Specify errors, versioning, pagination, and auth strategy.
|
|
4. Validate with examples and review for consistency.
|
|
|
|
Refer to `resources/implementation-playbook.md` for detailed patterns, checklists, and templates.
|
|
|
|
## Resources
|
|
|
|
- `resources/implementation-playbook.md` for detailed patterns, checklists, and templates.
|