api-design-principles
A skill from Seth Hobson's agents collection, in its backend-development plugin, with principles for designing REST and GraphQL APIs and for reviewing API specifications or setting team standards.
What the skill teaches
A skill from Seth Hobson's agents collection, in its backend-development plugin, with principles for designing REST and GraphQL APIs and for reviewing API specifications or setting team standards. For REST it covers resource-oriented URLs, HTTP method meaning, which methods are safe or idempotent, status codes and statelessness. For GraphQL it covers schema-first design, queries, mutations and subscriptions, cursor pagination in the Relay style and structured errors in mutation results. It compares three ways of versioning, and adds rate limiting, OpenAPI documentation, batching loaders to avoid repeated queries, deprecation and query complexity limits. Common mistakes include breaking changes, inconsistent errors and tying the API to the database schema.
Capabilities
- Design resource-oriented REST endpoints
- Design GraphQL schemas with cursor pagination
- Choose an API versioning strategy
- Review an API specification for common mistakes
About
- Publisher
- Seth Hobson
- Tool
- Code review
Install
The project doesn't document install steps that we could confirm. See the project's own instructions
What's inside
- assets/api-design-checklist.md
- assets/rest-api-template.py
- references/details.md
- references/graphql-schema-design.md
- references/rest-best-practices.md
MCP servers and skills can run code on your computer and act on your data. Review the source before installing.
Details
| Fact | Value | Source |
|---|---|---|
| Type | Skill | |
| Tool | Code review | |
| Publisher | Seth Hobson | source |
| Official status | Not stated in its documentation | |
| Needs an API key or sign-in | Not stated in its documentation | |
| Includes scripts | No | source |
| Platforms | Not stated in its documentation | |
| AI clients | Not stated in its documentation | |
| Licence | MIT | source |
| Pricing | Not stated in its documentation | |
| Activity | Last commit Nov 9, 202642,406 GitHub starsDownload data not available (not on npm or PyPI) | source |
| Links | Repository Website |
Copies of this skill in other repositories (13)
These differ from this skill's text. They may be adapted copies or older versions.
- api-design-principlesrmyndharis/antigravity-skills
- api-design-principlesdokhacgiakhoa/agent-skills-4-vibe-coding-cli
- api-design-principlesmicrock/ordinary-claude-skills
- api-design-principlessecondsky/claude-skills
- api-design-principlesagent-skills-hub/agent-skills-hub
- api-design-principlesovachiever/droid-tings
- api-design-principleslifangda/claude-plugins
- api-design-principlesonfire7777/universal-ai-skills-library
- api-design-principlesjuankcadavid/akili-specs
- api-design-principlestmolavi/mcp-agent-skills-hub
- api-design-principlesscaleto/antigravity-super-skill-architecture
- api-design-principleshk-hub/agentskills
- api-design-principlescarlopezzuto/agents
More from Seth Hobson
12 skills
- gitlab-ci-patterns (Skill)
- terraform-module-library (Skill)
- godot-gdscript-patterns (Skill)
- unity-ecs-patterns (Skill)
- k8s-manifest-generator (Skill)
- k8s-security-policies (Skill)
Also listed under: Code review
Sources
- Skill file (SKILL.md)github.com/wshobson/agentsNov 10, 2026
- GitHub repositorygithub.com/wshobson/agents · Backs: Publisher, Activity, LicenceNov 11, 2026
- Folder in the repository (api-design-principles)github.com/wshobson/agents · Backs: Includes scriptsNov 10, 2026