API Design Patterns

38 Regeln für REST-Endpunktbenennung, Fehler, Paginierung, Versionierung und API-Sicherheit.

von AsyrafHussin · AsyrafHussin/agent-skills

Getestet · Funktioniert ★ 9.6/10

API Design Patterns — 38 Regeln für REST-Endpunktbenennung, Fehler, Paginierung, Versionierung und API-Sicherheit.

Was es kann

Ein komprimiertes Regelwerk (38 Regeln / 7 Kategorien) für RESTful API-Design, das Ressourcenbenennung, Fehlerantwortform, Paginierung, Versionierung und Authentifizierung abdeckt. Wird beim Entwerfen oder Überprüfen von Endpunkten oder beim Schreiben von Fehlerbehandlungs-/Paginierungscode ausgelöst und verweist auf pro-Regel-Dateien (rules/*.md) und eine 7.200 Zeilen umfassende kompilierte AGENTS.md für tiefgehende Analysen.

Testbericht

Habe ein echtes 'Rechnungs-API'-Redesign durchlaufen lassen: Der Skill verwandelte verb-basierte URLs (POST /createInvoice) in Eigennamen, ersetzte einen bloßen Fehlerstring durch eine strukturierte Hülle (code/message/details/request_id) und fügte Cursor-Paginierungsmetadaten sowie HATEOAS-Links hinzu, die die naive Baseline nie hatte.

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

Installation

git clone https://github.com/AsyrafHussin/agent-skills
cd agent-skills
mkdir -p ~/.claude/skills
cp -r skills/api-design-patterns ~/.claude/skills/api-design-patterns

Befehle & Beispiel-Prompts

  • /api-design-patterns38 Regeln für REST-Endpunktbenennung, Fehler, Paginierung, Versionierung und API-Sicherheit.

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

  • Design a REST API for user management with proper error handling
  • Review my API endpoints for best practices before we ship
  • What HTTP status codes should I use for this validation error?