API Design Principles

Wendet REST- und GraphQL-Designprinzipien an, um klare, skalierbare APIs zu bauen.

von wshobson · wshobson/agents

Tested · Didn't pass

API Design Principles — Wendet REST- und GraphQL-Designprinzipien an, um klare, skalierbare APIs zu bauen.

Was es kann

Beherrscht REST- und GraphQL-API-Designprinzipien, um intuitive, skalierbare und wartbare APIs zu bauen, die Entwickler begeistern. Einsetzen beim Entwerfen neuer APIs, beim Review von API-Spezifikationen oder beim Festlegen von API-Designstandards.

Testbericht

Eine REST-Design-Aufgabe getestet (Bookmarking-Dienst: Endpoints, Versionierung, Pagination, JSON-Beispiele) mit und ohne den Skill. Beide Arme lieferten korrekte, vollständige Designs mit ressourcenorientierten Endpoints und URL-Versionierung; der Skill-Arm war vollständig best-practice-konform, wählte aber Offset/Page-Pagination, während der Base-Arm unabhängig die stärkere cursor-basierte Lösung mit schärferer Begründung fand. Verbatim-Installation und Frontmatter waren sauber; der Skill bringt bei dieser Aufgabe keinen messbaren Vorteil gegenüber einem starken Base-Modell.

Getestet am: 2026-07-11 · Claude Code 2.x (agent harness)

Installation

git clone https://github.com/wshobson/agents
cd agents
mkdir -p ~/.claude/skills
cp -r plugins/backend-development/skills/api-design-principles ~/.claude/skills/api-design-principles

Befehle & Beispiel-Prompts

  • /api-design-principlesWendet REST- und GraphQL-Designprinzipien an, um klare, skalierbare APIs zu bauen.

Skills reagieren auf normale Anfragen — keine Slash-Befehle nötig. Nach der Installation aktivieren Prompts wie diese den Skill (auf Englisch):

  • Review this REST API design for consistency issues
  • Design a GraphQL schema following best practices
  • Set API design standards for our new service