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.
O que a skill ensina
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.
O que faz
- Design resource-oriented REST endpoints
- Design GraphQL schemas with cursor pagination
- Choose an API versioning strategy
- Review an API specification for common mistakes
Sobre
- Publicador
- Seth Hobson
- Ferramenta
- Revisão de código
Instalação
O projeto não documenta passos de instalação que tenhamos conseguido confirmar. Veja as instruções do próprio projeto
O que tem dentro
- assets/api-design-checklist.md
- assets/rest-api-template.py
- references/details.md
- references/graphql-schema-design.md
- references/rest-best-practices.md
Servidores MCP e skills podem executar código no seu computador e agir sobre os seus dados. Revise o código-fonte antes de instalar.
Detalhes
| Fato | Valor | Fonte |
|---|---|---|
| Tipo | Skill | |
| Ferramenta | Revisão de código | |
| Publicador | Seth Hobson | fonte |
| Status oficial | Não informado na documentação | |
| Exige chave de API ou login | Não informado na documentação | |
| Inclui scripts | Não | fonte |
| Plataformas | Não informado na documentação | |
| Clientes de IA | Não informado na documentação | |
| Licença | MIT | fonte |
| Preço | Não informado na documentação | |
| Atividade | Último commit em 9 de nov. de 202642.406 estrelas no GitHubDados de download indisponíveis (não está no npm nem no PyPI) | fonte |
| Links | Repositório Site |
Outras cópias desta skill (13)
Elas têm diferenças no texto em relação a esta skill. Podem ser cópias adaptadas ou versões mais antigas.
- 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
Mais de Seth Hobson
21 skills
- github-actions-templates (Skill)
- gitlab-ci-patterns (Skill)
- multi-cloud-architecture (Skill)
- terraform-module-library (Skill)
- godot-gdscript-patterns (Skill)
- unity-ecs-patterns (Skill)
Também listado em: Revisão de código
Fontes
- Arquivo da skill (SKILL.md)github.com/wshobson/agents10 de nov. de 2026
- Repositório no GitHubgithub.com/wshobson/agents · Comprova: Publicador, Atividade, Licença11 de nov. de 2026
- Pasta no repositório (api-design-principles)github.com/wshobson/agents · Comprova: Inclui scripts10 de nov. de 2026