Api Design Principles
This is a solid foundation for anyone designing REST or GraphQL APIs from scratch or cleaning up existing ones. It walks you through the core decisions: picking an API style, modeling resources, handling errors, versioning, and auth. The implementation playbook promises checklists and templates, which should save you from reinventing pagination schemes for the hundredth time. Best used when you're early in the design phase and can still make structural choices. If your API is already public and locked in, or you just need framework-specific code examples, this won't help much. It's more about principles and consistency than hands-on implementation.
- skills.sh installs
- 824
- GitHub stars
- 43.1K
- last updated
- Jul 14, 2026
Install
$ npx -y skills add sickn33/antigravity-awesome-skills --skill api-design-principles --agent claude-codeInstalls into .claude/skills of the current project.
Files
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
- Define consumers, use cases, and constraints.
- Choose API style and model resources or types.
- Specify errors, versioning, pagination, and auth strategy.
- Validate with examples and review for consistency.
Refer to resources/implementation-playbook.md for detailed patterns, checklists, and templates.
Resources
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageDetails
- Repository
- github.com/sickn33/antigravity-awesome-skills
- Categories
- Backend & APIs, Design & UI/UX
- First seen
- May 16, 2026
More from sickn33/antigravity-awesome-skills
All 708- Planning With Files824
- Agent Evaluation815
- Agent Manager Skill814
- Bash Pro813
- Outlook Calendar Automation812
- Git Pushing810
- Codebase Cleanup Refactor Clean808
- Red Team Tactics808
- Claude Scientific Skills806
- Voice Ai Development804
- Code Reviewer796
- Architecture Patterns787
- Server Management782
- Quant Analyst775
- Data Scientist774
- Plan Writing772
- Voice Agents771
- Clerk Auth767
- Web Design Guidelines766
- Ai Wrapper Product762
- React Best Practices762
- Agent Orchestration Multi Agent Optimize760
- Prompt Caching760
- Notebooklm751
Recommended
More Backend & APIs
go-api-developmentmindrally/skillsGo API development guidelines using the standard library (1.22+) with best practices for RESTful API design, error handling, and security750skills.sh installs
supabase-pentestyoanbernabeu/supabase-pentest-skillsOrchestrate a complete Supabase security audit with guided step-by-step execution and ownership confirmation.725skills.sh installsauth0-authenticationmindrally/skillsGuidelines for implementing Auth0 authentication with best practices for security, rules, actions, and SDK integration724skills.sh installs