Overview
api-design-principles is an open-source backend skill for Claude Code and compatible agents, published by wshobson. Its author describes it as: “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.”. The project has 39k stars on GitHub and is available under the MIT license. Add it to your setup with `/plugin marketplace add wshobson/agents`.
What api-design-principles does
Master REST and GraphQL API design principles to build intuitive, scalable, and maintainable APIs that delight developers and stand the test of time.
What’s inside
The SKILL.md for api-design-principles is organised into these sections:
- When to Use This Skill
- Core Concepts
- 1. RESTful Design Principles
- 2. GraphQL Design Principles
- 3. API Versioning Strategies
- Detailed patterns and worked examples
- Best Practices
- REST APIs
- GraphQL APIs
- Common Pitfalls
Installation
Add api-design-principles to your agent with:
/plugin marketplace add wshobson/agentsReview a skill’s source before installing it — skills can instruct your agent to run commands. This command comes from the skill’s public repository, which is the source of truth for setup steps. New to skills? Read how to install Claude Code skills.
Supported agents
- Claude Code — ships a claude code plugin marketplace
- Codex — declared in the repository topics
- Cursor — declared in the repository topics
- OpenCode — declared in the repository topics
- GitHub Copilot — declared in the repository topics
- Antigravity — declared in the repository topics
License
api-design-principles is published under the MIT license.
Strengths
- Clear MIT license — safe to read and adapt within its terms
- Ships in wshobson/agents, an established project with 39,066 GitHub stars
- Works with Claude Code, Codex, Cursor, OpenCode, GitHub Copilot, Antigravity
- Actively maintained — repository updated in the last 90 days
- Its repository gained 669 GitHub stars over the last 24 days
Author
Topics
Alternatives to api-design-principles
Similar skills from other repositories:
Compare api-design-principles alternatives side by side →
Frequently asked questions
- What does api-design-principles do?
- 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.
- How do I install api-design-principles?
- Run /plugin marketplace add wshobson/agents in your agent, then reload your skills. Review the source at https://github.com/wshobson/agents before installing.
- Is api-design-principles free to use?
- Yes. api-design-principles is free and open source under the MIT license, so you can read, run, and adapt it within that license's terms.
- Which agents does api-design-principles work with?
- api-design-principles lists Claude Code, Codex, Cursor, OpenCode, GitHub Copilot, and Antigravity — named in its SKILL.md, its plugin marketplace or its repository topics. Skills use the portable SKILL.md format, so other agents that read that format may load it too.
- Where does api-design-principles come from?
- api-design-principles ships inside wshobson/agents, a repository that contains 54 catalogued skills in total. The repository's 39,066 GitHub stars apply to that whole collection, not to this skill on its own.
