API Design Principles skill: what it does and how to install it
Guides REST and GraphQL API design with conventions for resources, schemas, versioning, errors, pagination and documentation.
Summary generated from the skill's documentation.
Install
$ npx skills add wshobson/agents --skill api-design-principlesRun it in a terminal. If your agent is already running, start a new session so it picks the skill up.
About this skill
What it does. Covers resource-oriented REST design and schema-first GraphQL design, including HTTP methods, naming, versioning, pagination, rate limits, errors and documentation. It also addresses DataLoaders, validation, deprecation and query monitoring, with detailed patterns available for deeper guidance.
When to use it. For designing or refactoring APIs, reviewing specifications, setting team standards, planning migrations between REST and GraphQL, writing developer documentation or tailoring APIs for mobile and third-party integrations.
History
Repo stars
40.5k+245 since 5 Oct 2026
Stars are counted for the whole repository, which holds 26 skills.
Show as a table
| Date | Repo stars |
|---|---|
| 12 Oct 2026 | 40,457 |
| 11 Oct 2026 | 40,368 |
| 10 Oct 2026 | 40,319 |
| 9 Oct 2026 | 40,307 |
| 8 Oct 2026 | 40,296 |
| 7 Oct 2026 | 40,267 |
| 6 Oct 2026 | 40,238 |
| 5 Oct 2026 | 40,212 |
Installs
29.6k
Tracking since . A chart appears once there are 7 days of data.
Installs via skills.sh
Similar skills
- API and Interface DesignGuides the design of stable APIs and module boundaries, covering REST and GraphQL endpoints and type contracts between modules.
- Finishing a Development BranchGuides the choice of how to integrate finished work once tests pass: merge, pull request or cleanup.
- Writing SkillsGuides creating, editing and testing skills before they are deployed.