api-design-principles
Master REST and GraphQL API design including resource patterns, versioning, pagination, and architectural best practices.
Install
npx skills add https://github.com/wshobson/agents --skill api-design-principlesStats
| Total installs | 13,016 |
| Weekly installs | 13.0K |
| GitHub stars | 32.4K |
| First seen | Jan 20, 2026 |
| Source | @wshobson/agents |
Summary
- Covers resource-oriented REST patterns including HTTP method semantics, URL design, pagination, filtering, and error handling with consistent status codes
- Includes GraphQL schema-first development with type definitions, resolver patterns, Relay-style pagination, and DataLoader implementation for N+1 prevention
- Provides versioning strategies (URL, header, query parameter) and HATEOAS patterns for hypermedia-driven APIs
- Addresses common pitfalls like over-fetching, breaking changes, inconsistent error formats, and tight coupling between API structure and database schema
- Best practices for both paradigms covering naming conventions, statelessness, rate limiting, documentation, and deprecation strategies
Tags
Related skills
| Skill | Installs | vs api-design-principles |
|---|---|---|
| ai-sdk | 14,212 | +1,196 |
| changelog-maintenance | 10,934 | -2,082 |
| ad-creative | 17,986 | +4,970 |
| mcp-builder | 28,523 | +15,507 |
| pexo-agent | 15,064 | +2,048 |
FAQ
- How many installs does api-design-principles have?
- api-design-principles has 13,016 total installs and 13.0K installs this week.
- Where is api-design-principles hosted?
- api-design-principles is published by @wshobson/agents at https://github.com/wshobson/agents.
- How many GitHub stars does api-design-principles have?
- api-design-principles has 32.4K GitHub stars.
- When was api-design-principles first indexed?
- OrangeBot.AI first indexed api-design-principles on Jan 20, 2026.
- How do I install api-design-principles?
- Run: npx skills add https://github.com/wshobson/agents --skill api-design-principles