wshobson/agents

api-design-principles

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 API design standards.

All-time #975 Trending #2741 First seen Jan 20, 2026
8-week activity · all time api

Installation

$ npx skills add https://github.com/wshobson/agents
Feature your product here Skill page unit · reach builders installing agent skills View pricing →

Summary

  • REST and GraphQL API design principles for building scalable, developer-friendly APIs.
  • 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

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Security audits

Partner security reviews for this skill.

agent-trust-hub Reviewed

Analyzed Sep 14, 2026

snyk Reviewed

Analyzed Sep 14, 2026

socket Score 0.9000 · 0 alerts

Analyzed Sep 16, 2026

  • license 1
  • maintenance 1
  • quality 0.9
  • supply chain 1
  • vulnerability 1

0 alerts

Also in this package

Other skills from wshobson/agents · top by installs.

npx skills add https://github.com/wshobson/agents

Browse all from wshobson/agents

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 39.5K
License LICENSE
Default branch main
Open issues 4
Status Active

History

  1. First seen on skills.sh
  2. First recorded snapshot · 27,936 installs