wshobson/agents

api-design-principles

All-time #799 Trending #2059 Hot #5329 First seen Jan 20, 2026
8-week activity · all time api

Installation

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

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 SAFE

Analyzed Mar 8, 2026

This skill is an educational resource focused on API design principles, including templates and checklists. No security risks were identified.

snyk LOW

Analyzed Mar 8, 2026

No issues detected.

socket Score 0.9000 · 0 alerts

Analyzed Mar 18, 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