API Designer
Entwirft REST- oder GraphQL-APIs mit Ressourcenmodellen, Versionierung und Fehlerstandards.
Funktioniert mit Setup
Was es kann
Geeignet beim Entwurf von REST- oder GraphQL-APIs, beim Erstellen von OpenAPI-Spezifikationen oder bei der Planung der API-Architektur. Einsetzbar für Ressourcenmodellierung, Versionierungsstrategien, Paginierungsmuster und Fehlerbehandlungsstandards.
Testbericht
Wortgetreu installiert (Ziel auf das Arbeitsverzeichnis umgeleitet): Die SKILL.md-Frontmatter ist strict-YAML-valide, und alle fünf Referenzdateien (rest-patterns, versioning, pagination, error-handling, openapi) sind vorhanden und inhaltlich substanziell. Bei einer Design-Aufgabe für eine Bookmarks-REST-API lieferte der Skill ein korrektes, vollständiges Ergebnis — reine Substantiv-URIs, begründete Cursor-Paginierung, gültiges OpenAPI 3.1 und einen RFC-7807-Fehler. Das A/B gegen den No-Skill-Baseline-Arm war ein Unentschieden: Beide erfüllten alle Anforderungen in praktisch gleicher Qualität, der Skill liefert hier also solide Leitplanken, aber keinen transformativen Mehrwert.
Getestet am: 2026-07-12 · Claude Code 2.x (agent harness)
Installation
git clone https://github.com/Jeffallan/claude-skills cd claude-skills mkdir -p ~/.claude/skills cp -r skills/api-designer ~/.claude/skills/api-designer
Befehle & Beispiel-Prompts
/api-designerEntwirft REST- oder GraphQL-APIs mit Ressourcenmodellen, Versionierung und Fehlerstandards.
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 this new serviceWrite an OpenAPI spec for these endpointsPlan pagination and error handling for this API