API And Interface Design

Checklistengestütztes REST-/GraphQL- und TypeScript-Interface-Design mit Fehler- und Namensregeln.

von addyosmani · addyosmani/agent-skills

Getestet · Funktioniert ★ 9.6/10

API And Interface Design — Checklistengestütztes REST-/GraphQL- und TypeScript-Interface-Design mit Fehler- und Namensregeln.

Was es kann

Führt durch das Design stabiler REST-/GraphQL-Endpoints, Modulgrenzen und TypeScript-Typverträge nach Hyrums Gesetz, mit konsistenter Fehlersemantik, Grenzwertvalidierung und ausschließlich additiven Änderungen. Reagiert, wenn ein Nutzer neue Endpoints entwirft, Verträge zwischen Frontend und Backend oder zwischen Modulen definiert oder eine bestehende öffentliche Schnittstelle ändert.

Testbericht

Verwandelte ein verb-basiertes API-Design (POST /createBookmark, uneinheitliche Rückgaben) in saubere Ressourcen-Routen, eine einheitliche Fehlerform, Cursor-Pagination und einen gebrandeten ID-Typ.

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

Installation

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

Befehle & Beispiel-Prompts

/api-and-interface-designChecklistengestütztes REST-/GraphQL- und TypeScript-Interface-Design mit Fehler- und Namensregeln.

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

Design a REST endpoint for order refunds with consistent error semantics
Define the TypeScript contract between the frontend and this new service
Review this public API change for additive-only compatibility

Vollständiger Testbericht (Englisch) →