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.
Was der Skill vermittelt
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.
Funktionen
- Design resource-oriented REST endpoints
- Design GraphQL schemas with cursor pagination
- Choose an API versioning strategy
- Review an API specification for common mistakes
Überblick
- Herausgeber
- Seth Hobson
- Tool
- Code-Review
Installation
Das Projekt dokumentiert keine Installationsschritte, die wir bestätigen konnten. Zur Anleitung des Projekts
Was enthalten ist
- assets/api-design-checklist.md
- assets/rest-api-template.py
- references/details.md
- references/graphql-schema-design.md
- references/rest-best-practices.md
MCP-Server und Skills können Code auf deinem Rechner ausführen und auf deine Daten zugreifen. Prüfe den Quellcode, bevor du etwas installierst.
Details
| Angabe | Wert | Quelle |
|---|---|---|
| Typ | Skill | |
| Tool | Code-Review | |
| Herausgeber | Seth Hobson | Quelle |
| Offizieller Status | In der Dokumentation nicht angegeben | |
| Braucht API-Key oder Anmeldung | In der Dokumentation nicht angegeben | |
| Enthält Skripte | Nein | Quelle |
| Plattformen | In der Dokumentation nicht angegeben | |
| KI-Clients | In der Dokumentation nicht angegeben | |
| Lizenz | MIT | Quelle |
| Preis | In der Dokumentation nicht angegeben | |
| Aktivität | Letzter Commit am 9. Nov. 202642.406 GitHub-SterneKeine Download-Daten verfügbar (nicht auf npm oder PyPI) | Quelle |
| Links | Repository Website |
Kopien dieses Skills in anderen Repositorys (13)
Ihr Text weicht von diesem Skill ab. Es kann sich um angepasste Kopien oder ältere Versionen handeln.
- 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
Mehr von 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)
Auch zu finden unter: Code-Review
Quellen
- Skill-Datei (SKILL.md)github.com/wshobson/agents10. Nov. 2026
- GitHub-Repositorygithub.com/wshobson/agents · Belegt: Herausgeber, Aktivität, Lizenz11. Nov. 2026
- Ordner im Repository (api-design-principles)github.com/wshobson/agents · Belegt: Enthält Skripte10. Nov. 2026