- name
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 AP
SKILL.md
The skill file stays in the publisher's repository.
Paste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add wshobson/agents --skill api-design-principles -a cursor -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add wshobson/agents --skill api-design-principles -a claude-code -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add wshobson/agents --skill api-design-principles -a codex -yPaste the copied command in a terminal. It installs this SKILL.md into that agent.
npx skills add wshobson/agents --skill api-design-principles -a grok -ySend the copied message in a Grok Bot chat. The Bot fetches this SKILL.md from GitHub and adds it to the skills all your Bots share.
Install this skill: https://github.com/wshobson/agents/tree/HEAD/plugins/backend-development/skills/api-design-principlesFrom the publisher
Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers and stand the test of time.
Resource-Oriented Architecture
HTTP Methods Semantics:
GET: Retrieve resources (idempotent, safe)POST: Create new resourcesPUT: Replace entire resource (idempotent)PATCH: Partial resource updatesDELETE: Remove resources (idempotent)Schema-First Development
Query Structure:
URL Versioning:
/api/v1/users
/api/v2/users
Header Versioning:
Accept: application/vnd.api+json; version=1
Query Parameter Versioning:
/api/users?version=1
Detailed pattern documentation lives in references/details.md. Read that file when the navigation tier above is insufficient.
/users, not /user)@deprecated directive for gradual migration© 2026 Skills Rack.
---name: api-design-principlesdescription: Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight…---# plugins/backend-development/skills/api-design-principles/SKILL.mdOverview
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.
FAQ
Download plugins/backend-development/skills/api-design-principles/SKILL.md from the publisher, or copy the path and open the repository. PlugMCP lists the skill and does not host the file.
The publisher keeps it at https://github.com/wshobson/agents.
Claude, Cursor, Codex, and Grok Build can read a SKILL.md you add from the publisher's repository. Grok Bot installs it when you send the skill's GitHub folder link in a chat.